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Purpose 


This manual supplements information contained in the Administrator’s Reference 
Manual and the Programmer’s Reference Manual to provide an easy reference 
volume for those who must use a Unisys System V operating system. 


Scope 
{ ‘ This manual describes the user commands of the operating system. 


Audience 


The audience for this manual includes all users, programmers, analysts, and 
system support personnel. 


Prerequisites 


The user of this manual should be familiar with System V or another operating 
system derived from a UNIX” operating system. 


UNIX is a registered trademark of AT&T in the USA and other countries. 
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System Introduction 


vi 


This discussion provides the basic information you need to get started on your 
system: how to log in and log out, how to communicate through your terminal, 
and how to run a program. (See the User’s Guide for a more complete 
introduction to the system.) 


Logging In 


You must connect to the operating system from a full-duplex ASCII terminal. 
You must also have a valid login id obtained (together with how to access your 
operating system) from the administrator of your system. Common terminal 
speeds are 120, 240, 480, 960, and 1920 characters per second (1200, 2400, 4800, 
9600, and 19,200 baud). Some operating systems have different ways of accessing 
each available terminal speed, while other systems offer several speeds through a 
common access method. In the latter case, there is one preferred speed; if you 
access it from a terminal set to a different speed, you are greeted by a string of 
meaningless characters (the login: message at the wrong speed). Keep hitting the 
break, interrupt, or attention key until the login: message appears. 


Most terminals have a speed switch that should be set to the appropriate speed 
and a half-/full-duplex switch that should be set to full-duplex. When a 
connection has been established, the system types login:. You respond by typing 
your login id followed by the return key. If you have a password, the system asks 
for it but does not print, or echo, it on the terminal. After you have logged in, 
the return, new-line, and line-feed keys all have equivalent meanings. 


Make sure you type your login name in lowercase letters. Typing uppercase 
letters causes the operating system to assume that your terminal can generate 
only uppercase letters and treats all letters as uppercase for the remainder of 
your login session. The shell prints a $ on your screen when you have logged in 
successfully. 


When you log in, a message-of-the-day may greet you before you receive your 
prompt. For more information, consult Jogin(1), which discusses the login 
sequence in more detail, and stty(1), which tells you how to describe your 
terminal to the system. profile(4) (in the Programmer’s Reference Manual) 
explains how to accomplish this last task automatically every time you log in. 
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Logging Out 


There are two ways to log out: 
e If you’ve dialed in, you can simply hang up the phone. 


° You can log out by typing an end-of-file indication (ASCII EOT character, 
usually typed as < Ctrl > D) to the shell. The shell terminates, and the 
login: message appears. 


How to Communicate Through Your Terminal 


When you type, the operating system gathers and temporarily saves your 
individual characters in a buffer. Although they echo back to you, these 
characters do not go to a program until you type a return (or new-line) as 
described above. 


Operating system terminal input/output is full duplex. It has full read-ahead, 
which means that you can type at any time, even while a program runs. Of 
course, if you type during output, your input characters have output characters 
interspersed among them. In any case the system saves whatever you type and 
interprets it in the correct sequence. The read-ahead buffer has a generous limit 
a user should not likely exceed. 


The character @ (the line kill character) cancels all the characters typed before 
it on a line, effectively deleting the line. The character # erases the last 
character typed. Successive uses of # erases characters back to, but not beyond, 
the beginning of the line; Precede @ and # with \ to stand for themselves. Thus, 
to erase a \, you need two #s. You can change these default erase and line kill 
characters; see stty(1). 


Type < Ctrl > S (also known as the ASCII DC3 character) by pressing the 
control key and the alphabetic s simultaneously to stop output temporarily. It 
prevents output from disappearing too fast on CRT terminals. Output resumes 
by typing < Ctrl > Q (also known as DC1). Thus, if you had typed cat yourfile 
and the contents of yourfile were passing by on the screen more rapidly than you 
could read it, you would type < Ctrl > S to freeze the output for a moment. 
Typing < Ctrl > Q allows the output to resume its rapid pace. The < Ctrl > 
S and < Ctrl > Q characters are not passed to any other program when used in 
this manner. Alternatively type pg yourfile to see a screenful at a time. 
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The ASCII < Del > (a.k.a. rubout) character is not passed to programs but 

instead generates an interrupt signal, just like the break, interrupt, or attention 

signal. This signal generally causes a running program to terminate. It is w/ 
typically used to stop a long printout that you do not want. Programs, however, 

can arrange either to ignore this signal altogether or take a specific action when 

it happens (instead of terminating). The editor ed(1), for example, catches 

interrupts and stops what it is doing, instead of terminating, so an interrupt can 

be used to halt an editor printout without losing the file being edited. 


Besides adapting to the speed of the terminal, the operating system tries to 
determine whether you have a terminal with the new-line function, or whether to 
simulate it with a carriage-return and line-feed pair. In the latter case, all input 
carriage-return characters change to line-feed characters (the standard line 
delimiter), and a carriage-return and line-feed pair echo to the terminal. If you 
get into the wrong mode, the stty(1) command rescues you. 


Operating system source programs can freely use < Tab > characters. If your 
terminal does not have the tab function, you can arrange to have tab characters 

changed into spaces during output, and echoed as spaces during input. Again, ) 
the stty(1) command sets or resets this mode. The system assumes that tabs are WwW 
set every eight character positions. The tabs(1) command sets tab stops on your 
terminal, if that is possible. 


When you have successfully logged into the operating system, a program called 

the shell is communicating with your terminal. The shell reads each line you 

type, splits the line into a command name and its arguments, and executes the 
command. A command is simply an executable program. Normally, the shell 

looks first in your current directory (see "The Current Directory" that follows) for 

the named program and, if not there, then in system directories, such as /bin and 
/usr/bin. System-provided commands reside in directories where the shell can 

find them. You can also keep commands in your own directories and instruct the 
shell to find them there. See the manual entry for sh(1), under the sub-heading 
Parameter Substitution, for the discussion of the $PATH shell environment , 
variable. The command name is the first word on an input line to the shell. Nad 
Space or tab characters separate the command and its arguments from one 

another. 


| 
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| 
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The ASCII < Del > (a.k.a. rubout) character is not passed to programs but 
instead generates an interrupt signal, just like the break, interrupt, or attention 
signal. This signal generally causes a running program to terminate. It is 
typically used to stop a long printout that you do not want. Programs, however, WY 
can arrange either to ignore this signal altogether or take a specific action when 

it happens (instead of terminating). The editor ed(1), for example, catches 

interrupts and stops what it is doing, instead of terminating, so an interrupt can 

be used to halt an editor printout without losing the file being edited. 


Besides adapting to the speed of the terminal, the operating system tries to 
determine whether you have a terminal with the new-line function, or whether to 
simulate it with a carriage-return and line-feed pair. In the latter case, all input 
carriage-return characters change to line-feed characters (the standard line 
delimiter), and a carriage-return and line-feed pair echo to the terminal. If you 
get into the wrong mode, the stty(1) command rescues you. 


Operating system source programs can freely use < Tab > characters . If your 
terminal does not have the tab function, you can arrange to have tab characters 
changed into spaces during output, and echoed as spaces during input. Again, ’ 
the stty(1) command sets or resets this mode. The system assumes that tabs are FF 
set every eight character positions. The tabs(1) command sets tab stops on your 

terminal, if that is possible. 


How to Run a Program 


When you have successfully logged into the operating system, a program called 

the shell is communicating with your terminal. The shell reads each line you 

type, splits the line into a command name and its arguments, and executes the 
command. A command is simply an executable program. Normally, the shell 

looks first in your current directory (see "The Current Directory" that follows) for 

the named program and, if not there, then in system directories, such as /bin and 
/usr/bin. System-provided commands reside in directories where the shell can 

find them. You can also keep commands in your own directories and instruct the 

shell to find them there. See the manual entry for sh(1), under the sub-heading 
Parameter Substitution, for the discussion of the $PATH shell environment _ 
variable. The command name is the first word on an input line to the shell. f 
Space or tab characters separate the command and its arguments from one Ww 
another. 
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When a program terminates, the shell ordinarily regains control and gives you 
back your prompt to indicate that it is ready for another command. sh(1) 
f \ describes in detail many other capabilities of the shell. 


The Current Directory 


The operating system has a file system arranged in a hierarchy of directories. 
When you received your login id, the system administrator also created a 
directory for you (ordinarily with the same name as your login id, and known as 
your /ogin or home directory). When you log in, that directory becomes your 
current or working directory, and any file name you type is, by default, assumed to 
be in that directory. As the owner of this directory, you have full permissions to 
read, write, alter, or remove its contents. Permissions to enter or modify other 
directories and files have been granted or denied to you by their respective 
owners or by the system administrator. To change the current directory, use 
cd(1). 


rf~ Pathnames 


To refer to files or directories not in the current directory, you must use a 
pathname. Full pathnames begin with /, which is the name of the voot directory 
of the whole file system. After the slash comes the name of each directory 
containing the next sub-directory (followed by a /), until finally the file or 
directory name is reached (e.g., /usr/ae/filex refers to file filex in directory ae, 
while ae is itself a subdirectory of usr, and usr belongs to root as a subdirectory). 
Use pwd(1) to print the full pathname of the directory you are working in. See 
intro(2) in the Programmer’s Reference Manual for a formal definition of 
pathname. 


If your current directory contains subdirectories, the pathnames of their 
respective files begin with the name of the corresponding subdirectory (without a 
prefixed /). A pathname may be used anywhere a file name is required. 


Important commands that affect files are cp(1), mv [see cp(1)], and mm (1), which 

~~ respectively copy, move (i.e., rename), and remove files. To find out the status of 

| files or directories, use /s(1). Use mkdir(1) for making directories and rmdir [see 
rm(1)] for removing them. 
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Text Entry and Display 


Almost all text is entered through an editor. Common examples of operating | | 
system editors are ed(1) and vi(1). The commands most often used to print text Na 
on a terminal are cat(1), pr(1), and pg(1). The cat(1) command displays the 

contents of ASCII text files on the terminal, with no processing at all. The pr(1) 

command paginates the text, supplies headings, and has a facility for multi- 

column output. The pg(1) command displays text in successive portions no larger 

than your terminal screen. 


Writing a Program 


Once you have entered the text of your program into a file with an editor, you 

can give the file to the appropriate language processor. The processor accepts 

only files observing the correct naming conventions: all C programs must end 

with the suffix .c, and FORTRAN programs must end with .f. The output of the 

language processor is left in a file named a.out in the current directory, unless 

you have invoked an option to save it in another file. (Use mv(1) to rename 

a.out.) If the program is written in assembly language, you may need to load < 
library subroutines with it (see /d(1) in the Programmer’s Reference Manual). a 


When you have completed this process without provoking any diagnostics, you 
may run the program by giving its name to the shell in response to the $ prompt. 
Your programs can receive arguments from the command line just as system 
programs do; see exec(2) in the Programmer’s Reference Manual. For more 
information on writing and running programs, see the Programmer’s Guide. 


Communicating with Others 


Certain commands provide inter-user communication. Even if you do not plan to 

use them, it would be well to learn something about them because someone else 

may try to contact you. mail(1) or mailx(1) leave a message that announces its 

existence to another user, when he or she next logs in, and at periodic intervals 

during the session. Use write(1) to communicate with another user currently 

logged in. The corresponding entries in this manual also suggest how to respond _— 
to these two commands for the recipient of the message. WZ 


See the tutorials in the User’s Guide for more information on communicating 
with others. 
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How to Use This Document 


The commands appear as follows: 


1. Commands and Application Programs 


The section begins with a page labeled intro. Entries, arranged alphabetically, 
follow the intro page and may consist of more than one page. Some entries 
describe several routines, commands, etc. In such cases, the entry appears only 
once, alphabetized under its primary name (command). For example, chown(1) 
also describes the chgrp command. 


References with numbers other than those mentioned previously appear in the 
appropriate section of another manual. References with a (1M), (7) or (8) 
following the command name mean that the man page usually occurs in the 
Administrator’s Reference Manual. Some (1M) references and those with a (1), 
(1B), (1C), or (1G) can be found in either the User’s Reference Manual or the 
Programmer’s Reference Manual. All other referenced commands including (2), 
(3), (3C), (3X), (3M), (3S), GW), (GN), (4) and (5) appear in the Programmer’s 
Reference Manual. 


Organization 


This manual contains the following sections: 
Permuted Index 


This index derives from the Table of Contents (which lists both primary and 
secondary command entries and gives an abstract of each command). To use the 
Permuted Index, search the middle column for a key word or phrase. The right 
column contains the name of the manual page that contains the command. The 
left column contains additional useful information about the command. 
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Section 1. Commands and Application Programs 


The entries in Section 1 describe programs intended to be invoked directly by the | 2 
user or by command language procedures, as opposed to subroutines, which the WwW 
user’s program calls. These include general utility commands, commands used in 
communicating with other systems, and commands used for graphics and 

computer-aided design. Commands generally reside in the directory /bin (for 

binary programs). In addition, some programs reside in /usr/bin. The command 
interpreter called the shell searches these directories automatically. UNIX 

systems running on Unisys computers also have a directory called /usr/Ibin, 

containing local commands. 


All entries use the following format (though some entries might not use every 
heading): 


e NAME gives the primary name (and secondary name(s), if they exist) and 
briefly states its purpose. 


e SYNOPSIS summarizes the usage of the program being described. A few 
explanatory conventions are used, particularly in the SYNOPSIS: 


ae 


e Boldface strings are literals. Type them just as they appear. WY 


e Italic strings usually represent substitutable argument prototypes and 
command names found elsewhere in the manual. 


e Square brackets [] around an argument prototype indicate an optional 
argument. When an argument prototype appears as "name" or "file," it 
always refers to a file name. 


e Ellipses ... show that the previous argument prototype may be repeated. 


e A final convention is used by the commands themselves. An argument 
beginning with a minus (-), plus (+), or an equal sign (=) is often taken 
to be some kind flag argument, even if it appears in a position where a 
file name could appear. Therefore, it is unwise to have files whose 
names begin with -, +, or =. 


e DESCRIPTION provides an overview of the utility. 
e EXAMPLES gives examples of usage, where appropriate. , 


e FILES contains the file names the program references. 
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e EXIT CODES discusses values set when the command terminates. Type the 
shell environment variable "?" [see sh(1)] to see the value set. 


e RETURN VALUES identifies values returned during the execution of a 
command and/or program. 


e NOTES and CAVEATS provides information that may be helpful under the 
particular circumstances described. 


e SEE ALSO offers pointers to related information. 


e DIAGNOSTICS discusses the error messages that may appear. Self- 
explanatory messages are not listed. 


e WARNINGS discusses the limits or boundaries of the respective commands. 


e BUGS lists known, unrectified faults in software. Occasionally, a suggested 
short-term remedy is also described. 


¢ RESTRICTIONS provides known restrictions and deficiencies. Occasionally, 
the suggested fix is also described. 


Related Product Information 


Programmer’s Reference Manual 
Administrator’s Reference Manual 
User’s Guide 

Editing Guide 

Administration Guide 
Documenter’s Workbench 
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NAME 
o™ intro - introduction to commands and application programs 


-DESCRIPTION 
This section describes, in alphabetical order, commands available for Unisys V 
operating systems. Certain distinctions of purpose are made in the headings. 


The following Utility packages are delivered with the computer: 


Basic Networking Utilities 

Tape Controller Utilities 

Directory and File Management Utilities 

Editing Utilities 

Essential Utilities 

Graphics Utilities 

Help Utlities 

Inter-process Communications 

Line Printer Spooling Utilities 
Performance Measurement Utlities 

Spell Utilities 

Terminal Filter Utilities 

Terminal Information Utilities 

User Environment Utilities 


The following Utility Package is available for purchase: 


Remote File Sharing Utilities 


Manual Page Command Syntax 

Unless otherwise noted, commands described in the SYNOPSIS section of a 

manual page accept options and other arguments according to the following 
syntax and should be interpreted as explained below. 


name [-option...] [cmdarg...] 
where: 


o™ (] Surround an option or cmdarg that is not required. 


Indicates multiple occurrences of the option or cmdarg. 
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name 


option 


noargletter 


argletter 


optarg 


cmdarg 


The name of an executable file. 


(Always preceded by a - .) 
noargletter... Or, 
argletter optarg{,...| 


A single letter representing an option without an option- 
argument. Note that more than one noargletter option can be 
grouped after one - (Rule 5, below). 


A single letter representing an option requiring an option- 
argument. 


An option-argument (character string) satisfying a preceding 
argletter. Note that groups of optargs following an argletter must 
be separated by commas, or separated by white space and quoted 
(Rule 8, below). 


Pathname (or other command argument) not beginning with - , 
or - by itself indicating the standard input. 


Command Syntax Standard: Rules 
These command syntax rules are not followed by all current commands, but all 
new commands obey them. gefopts(1) should be used by all shell procedures to 
parse positional parameters and to check for legal options. It supports Rules 
3-10 below. The enforcement of the other rules must be done by the command 


itself. 


aw SS PY 
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Command names (name above) must be between two and nine 
characters long. 


Command names must include only lower-case letters and digits. 
Option names (option above) must be one character long. 

All options must be preceded by - . 

Options with no arguments may be grouped after a single -. 


The first option-argument (optarg above) following an option must be 
preceded by white space. 


Option-arguments cannot be optional. 


Groups of option-arguments following an option must either be 
separated by commas or separated by white space and quoted (e.g., 
-O XXX,Z,yy OF -O "Xxx Z yy"). 
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9. All options must precede operands (cmdarg above) on the command 


10. _-- may be used to indicate the end of the options. 
11. The order of the options relative to one another should not matter. 


12. The relative order of the operands (crndarg above) may affect their 
significance in ways determined by the command with which they 


appear. 
13. - preceded and followed by white space should only be used to mean 
standard input. 
SEE ALSO 
getopts(1) 


exit(2), wait(2), getopt(3C) in the Programmer’s Reference Manual 
The About This Document Section, at the front of this document 


DIAGNOSTICS 
y Upon termination, each command returns two bytes of status, one supplied by 
the system and giving the cause for termination, and (in the case of "normal" 
termination) one supplied by the program [see wait(2) and exut(2)]. The former 
byte is 0 for normal termination; the latter is customarily 0 for successful 
execution and non-zero to indicate troubles such as erroneous parameters, or bad 


or inaccessible data. It is called variously "exit code", "exit status", or "return 
code", and is described only where special conventions are involved. 


WARNINGS 
Some commands produce unexpected results when processing files containing 
null characters. These commands often treat text input lines as strings and 
therefore become confused upon encountering a null character (the string 
terminator) within a line. 
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NAME 
300, 300s - handle special functions of DASI 300 and 300s terminals 


SYNOPSIS 
300 [ +12 ] [ -n ] [ -dt],c ] 


300s [ +12] [ -n] [ -dtc ] 


DESCRIPTION 
The 300 command supports special functions and optimizes the use of the DASI 
300 (GSI 300 or DTC 300) terminal; 300s performs the same functions for the 
DASI 300s (GSI 300s or DTC 300s) terminal. It converts half-line forward, half- 
line reverse, and full-line reverse motions to the correct vertical motions. In the 
following discussion of the 300 command, it should be noted that unless your 
system contains the DOCUMENTER’S WORKBENCH software, references to 
certain commands (e.g., nroff, neqn, eqn, etc.) do not work. It also attempts to 
draw Greek letters and other special symbols. It permits convenient use of 12- 
pitch text. It also reduces printing time 5 to 70%. The 300 command can be 
used to print equations neatly, in the sequence: 


neqn file ... | nroff | 300 


WARNING: if your terminal has a PLOT switch, make sure it is turned on 
before 300 is used. 


The behavior of 300 can be modified by the optional flag arguments to handle 
12-pitch text, fractional line spacings, messages, and delays. 


a al permits use of 12-pitch, 6 lines/inch text. DASI 300 terminals normally 
allow only two combinations: 10-pitch, 6 lines/inch, or 12-pitch, 8 
lines/inch. To obtain the 12-pitch, 6 lines per inch combination, the 
user should turn the PITCH switch to 12, and use the +12 option. 


-1 controls the size of half-line spacing. A half-line is, by default, equal 
to 4 vertical plot increments. Because each increment equals 1/48 of 
an inch, a 10-pitch line-feed requires 8 increments, while a 12-pitch 
line-feed needs only 6. The first digit of n overrides the default value, 
thus allowing for individual taste in the appearance of subscripts and 
superscripts. For example, nroff half-lines could be made to act as 
quarter-lines by using -2. The user could also obtain appropriate 
half-lines for 12-pitch, 8 lines/inch mode by using the option -3 alone, 
having set the PITCH switch to 12-pitch. 


-dt,l,c controls delay factors. The default setting is -d3,90,30. DASI 300 
terminals sometimes produce peculiar output when faced with very 
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long lines, too many tab characters, or long strings of blankless, non- 

identical characters. One null (delay) character is inserted in a line + 
for every set of t tabs, and for every contiguous string of c non-blank, a 
non-tab characters. If a line is longer than / bytes, 1+ (total length)/20 

nulls are inserted at the end of that line. Items can be omitted from 

the end of the list, implying use of the default values. Also, a value of 

zero for ¢ (c) results in two null bytes per tab (character). The former 

may be needed for C programs, the latter for files like /etc/passwd. 

Because terminal behavior varies according to the specific characters 

printed and the load on a system, the user may have to experiment 

with these values to get correct output. The -d option exists only as a 

last resort for those few cases that do not otherwise print properly. 

For example, the file /etc/passwd may be printed using -d3,30,5. The 

value -d0,1 is a good one to use for C programs that have many levels 

of indentation. 


Note that the delay control interacts heavily with the prevailing 
carriage return and line-feed delays. The stty(1) modes nl0 cr2 or nl0 
cr3 are recommended for most uses. 


The 300 command can be used with the nvoff -s flag or .rd requests, when it is a, 
necessary to insert paper manually or change fonts in the middle of a document. 

Instead of hitting the return key in these cases, you must use the line-feed key to 

get any response. 


In many (but not all) cases, the following sequences are equivalent: 


nroff -T300 files... and _ nroff files... | 300 
nroff -T300-12 files... and _ nroff files... | 300 +12 


The use of 300 can thus often be avoided unless special delays or options are 
required; in a few cases, however, the additional movement optimization of 300 
may produce better-aligned output. 


The neqn names of, and resulting output for, the Greek and special characters 
supported by 300 are shown in greek(5). 


SEE ALSO 
450(1), mesg(1), graph(1G), stty(1), tabs(1), tplot(1G) | 
eqn(1), nroff(1), tbl(1) in the DOCUMENTER’S WORKBENCH reference New 
manuals 
greek(5) in the Programmer’s Reference Manual 
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BUGS 
Some special characters cannot be correctly printed in column 1 because the 
print head cannot be moved to the left from there. 


If your output contains Greek and/or reverse line-feeds, use a friction-feed platen 
instead of a forms tractor; although good enough for drafts, the latter has a 
tendency to slip when reversing direction, distorting Greek characters and 
misaligning the first line of text after one or more reverse line-feeds. 
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NAME 
4014 - paginator for the Tektronix 4014 terminal 


SYNOPSIS 
4014 [ -t ] [ -n ] [ -N ] [ -pL ] [ file ] 


DESCRIPTION 

The output of 4014 is intended for a Tektronix 4014 terminal; 40/4 arranges for 
66 lines to fit on the screen, divides the screen into N columns, and contributes 
an eight-space page offset in the (default) single-column case. Tabs, spaces, and 

_ backspaces are collected and plotted when necessary. Teletype Model 37 half- 
and reverse-line sequences are interpreted and plotted. At the end of each page, 
4014 waits for a newline (empty line) from the keyboard before continuing on to 
the next page. In this wait state, the command !cmd sends the cmd to the shell. 


The command line options are: 

-t Do not wait between pages (useful for directing output into a file). 

-n Start printing at the current cursor position and never erase the screen. 
die -cN Divide the screen into N columns and wait after the last column. 


-pL Set page length to L; L accepts the scale factors i (inches) and 1 (lines); 
default is lines. 


SEE ALSO 


pr(1) 
troff(1) in the DOCUMENTER’S WORKBENCH reference manuals 
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NAME 
| o™~ 450 - handle special functions of the DASI 450 terminal 


SYNOPSIS 
450 


DESCRIPTION 
The 450 command supports special functions of, and optimizes the use of, the 
DASI 450 terminal, or any terminal that is functionally identical, such as the 
Diablo 1620 or Xerox 1700. It converts half-line forward, half-line reverse, and 
full-line reverse motions to the correct vertical motions. It also attempts to draw 
Greek letters and other special symbols in the same manner as 300(1). It should 
be noted that, unless your system contains DOCUMENTER’S WORKBENCH 
software, certain commands (e.g., eqn, nroff, tbl, etc.) do not work. Use 450 to 
print equations neatly, in the sequence: 


neqn file ... | nroff | 450 


WARNING: make sure that the PLOT switch on your terminal is ON before 
i 450 is used. The SPACING switch should be put in the desired position (either 
} 10- or 12-pitch). In either case, vertical spacing is 6 lines/inch, unless dynamically 
changed to 8 lines per inch by an appropriate escape sequence. 


Use 450 with the nroff -s flag or .rd requests when it is necessary to insert paper 
manually or change fonts in the middle of a document. Instead of hitting the 
return key in these cases, you must use the line-feed key to get any response. 


In many (but not all) cases, the use of 450 can be eliminated in favor of one of 
the following: 


nroff -T450 files .. 
or 
nroff -T450-12 files ... 


The use of 450 can thus often be avoided unless special delays or options are 
required; in a few cases, however, the additional movement optimization of 450 
may produce better-aligned output. 


The negn names of, and resulting output for, the Greek and special characters 
y= supported by 450 are shown in greek(5). 
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SEE ALSO 
300(1), mesg(1), stty(1), tabs(1), graph(1G), tplot(1G) 
eqn(1), nroff(1), tbl(1) in the DOCUMENTER’S WORKBENCH reference 
manuals 
greek(5) in the Programmer’s Reference Manual 


BUGS 
Some special characters cannot be correctly printed in column 1 because the 
print head cannot be moved to the left from there. 


If your output contains Greek and/or reverse line-feeds, use a friction-feed platen 
instead of a forms tractor; although good enough for drafts, the latter has a 
tendency to slip when reversing direction, distorting Greek characters and 
misaligning the first line of text after one or more reverse line-feeds. 
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NAME 
lan acctcom - search and print process accounting files 


SYNOPSIS 
acctcom [[options][file]]... 


DESCRIPTION 
The acctcom command reads file, the standard input, or /usr/adm/pacct, in the 
form described by acct(4) and writes selected records to the standard output. 
Each record represents the execution of one process. 


The output shows the following: 


COMMAND NAME _-- prepended with a # if executed with 
superuser privileges. 

USER - 

TTYNAME - a ? if a process is not associated 
with a known terminal type. 

START TIME - 

~~ END TIME 

REAL (SEC) - 

CPU (SEC) - 

MEAN SIZE(K) - 

F - (optional) fork/exec flag: 1 for fork 
without exec. 

STAT - (optional) the system exit status. 

HOG FACTOR - 

KCORE MIN - 

CPU FACTOR - 

CHARS TRNSFD - 

BLOCKS R/W - total blocks read and written. 


If no files are specified, and if the standard input is associated with a terminal or 
/dev/null (as is the case when using & in the shell), /usr/adm/pacct is read, 
otherwise the standard input is read. 


o™ file arguments (if given) are read in their respective order. Each file is normally 
read forward, i.e., in chronological order by process completion time. The file 
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/usr/adm/pacct is usually the current file to be examined; a busy system may 
need several such files of which all but the current file are found in 


/usr/adm/pacct. 
OPTIONS 

-a Show some average statistics about the process selected. The statistics 
are printed after the output records. 

-b Read backwards, showing latest commands first. This option has no 
effect when the standard input is read. 

-f Print the fork/exec flag and system exit status columns in the output. 

-h Instead of mean memory size, show the fraction of total available CPU 
time consumed by the process during its execution. This CPU "hog" 
time factor is computed as: 

(total CPU time)/(elapsed time) 

-i Print columns containing the I/O counts in the output. 

-k Instead of memory size, show total kcore-minutes. 

-m Show mean core size (the default). 

-r Show CPU factor: (user time/(system-time + user-time)). 

-t Show separate system and user CPU times. 

-V Exclude column headings from the output. 

-l line | Show only processes belonging to terminal /dev/line. 

-uuser Show only processes belonging to user that may be specified by: 

user ID a login name converted to a user ID 

# designates only those processes executed with 
superuser privileges 

? designates processes associated with unknown user 
IDs 

-g group Show only processes belonging to group. The group may be designated 
by either the group ID or group name. 

-s time Select processes existing at or after fie, given in the format 
hr[:min [:sec }]. 

-e time Select processes existing at or before time. 
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-S time Select processes starting at or after time. 


-E time Select processes ending at or before time. Using the same time for 
both -S and -E shows the processes that existed at time. 


-n pattem 
Show only commands matching pattem that may be a regular expression 
as in ed(1) except that + means one or more occurrences. 


-q Do not print any output records; print the average statistics as with the 
-a option. 


-0 ofile Copy selected process records in the input data format to ofile; 
suppress standard output printing. 


-H factor 
Show only processes that exceed the CPU time factor, explained under 
the -h option. 


-O sec Show only processes with CPU system time exceeding sec seconds. 


-C sec Show only processes with total CPU time, system plus user, exceeding 
sec seconds. 


-I chars Show only processes transferring more characters than the cut-off 
number given by chars. 


FILES 
/etc/passwd 
/usr/adm/pacct 
/etc/group 


SEE ALSO 
ps(1), su(1) 
acct(2), acct(4), utmp(4) in the Programmer’s Reference Manual 
acct(1M), acctcms(1M), acctcon(1M), acctmerg(1M), acctprc(1M), acctsh(1M), 
fwtmp(1M), runacct(1M) in the Administrator’s Reference Manual 


RESTRICTIONS 
The acctcom command only reports on processes that have terminated; use ps(1) 
for active processes. If time exceeds the present time, then fime is interpreted as 
occurring on the previous day. 
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NAME 
‘“™ assist - assistance using UNIX system commands 


SYNOPSIS 
assist [name] 
assist [-s] 
assist [-c name] 


DESCRIPTION 
The assist command invokes the ASSIST menu interface software for the UNIX 
system. The ASSIST menus categorize UNIX system commands according to 
function in a hierarchy. The menus lead to full-screen forms (called command 
forms) that aid in the execution of a syntactically correct UNIX system command 
line. The menus also lead to interactive simulations of UNIX system commands 
or concepts (called walkthrus). 


If you type assist without options, you enter at the top of the menu interface 
hierarchy. New users may wish to use the -s option to select an introductory 
tutorial explaining how to use the ASSIST software. 


OPTIONS 
name invoke an ASSIST-supported UNIX system command form or 
walkthru for narne 


-cname invoke the version of name that is in your current directory 


-S reinvoke the ASSIST setup module and check or modify your 
terminal variable; or access the introductory information about 
ASSIST 


When you invoke assist, you perform operations within the program by using 
assist commands. To see a list of the assist commands, type < Ctrl > A when 
you are in assist. When you do this, a list of the commands 1s printed on the 
terminal screen. 


EXAMPLES 
This example illustrates how to invoke a particular command form directly. In 
rn this case, mkdir is the desired command form. 


assist mkdir 
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FILES 
$SHOME/ assistre information needed by assist (for example, about the 
terminal you are using) 
/usr/lib/assist default directory containing assist command forms, 
walkthrus, and executable programs 
/usr/lib/readme/assist basic information about installing assist and astgen 
NOTES 


The first time you invoke assist it ignores any options you give and asks for 
information about the terminal you are using. Once it has saved this information 
in a file named .assistrc in your home directory, it shows you a list of basic assist 
commands and offers you an introduction to ASSIST. 


RESTRICTIONS 
The assist command does not support all system commands. 
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NAME 
ie at, batch - execute commands at a later time 


SYNOPSIS 
at time [ date | [ + increment | 
at -r job... 
at -/ [ job ... | 


batch 


DESCRIPTION 
The at and batch read commands from standard input to be executed at a later 
time. at allows you to specify when the commands should be executed, while jobs 
queued with batch execute when system load level permits. at may be used with 
the following options: 


-r | Removes jobs previously scheduled with at. 
-|_ Reports all jobs scheduled for the invoking user. 


~~ Standard output and standard error output are mailed to the user unless they are 

redirected elsewhere. The shell environment variables, current directory, umask, 
and ulimit are retained when the commands are executed. Open file descriptors, 
traps, and priority are lost. 


Users are permitted to use at if their name appears in the file 
/usr/lib/cron/at.allow. If that file does not exist, the file /usr/lib/cron/at.deny is 
checked to determine if the user should be denied access to at. If neither file 
exists, only root is allowed to submit a job. If at.deny is empty, global usage is 
permitted. The allow/deny files consist of one user name per line. These files 
can only be modified by the superuser. 


The time may be specified as 1, 2, or 4 digits. One and two digit numbers are 
taken to be hours, four digits to be hours and minutes. The time may alternately 
be specified as two numbers separated by a colon, meaning hour:minute. A 
suffix am or pm may be appended; otherwise a 24-hour clock time is understood. 
The suffix zulu may be used to indicate GMT. The special names noon, 
midnight, now, and next are also recognized. 


eo An optional date may be specified as either a month name followed by a day 
number (and possibly year number preceded by an optional comma) or a day of 
the week (fully spelled or abbreviated to three characters). Two special "days", 
today and tomorrow are recognized. If no date is given, today is assumed if the 


UP-13525 V1 R1 Page 1 


AT(1) 


given hour is greater than the current hour and tomorrow is assumed if it is less. 
If the given month is less than the current month (and no year is given), next year) 
is assumed. 


The optional increment is simply a number suffixed by one of the following: 
minutes, hours, days, weeks, months, or years. (The singular form is also 
accepted.) 


Thus legitimate commands include: 


at O0815am Jan 24 
at 8:15am Jan 24 
at now + 1 day 
at 5 pm Friday 


at and batch write the job number and schedule time to standard error. 


batch submits a batch job. It is almost equivalent to "at now’, but not quite. For 
one, it goes into a different queue. For another, "at now" responds with the error 
message too late. 


at -r removes jobs previously scheduled by at or batch. The job number is the 
number given to you previously by the at or batch command. You can also get Ww 
job numbers by typing at -l. You can only remove your own jobs unless you are 

the superuser. 


EXAMPLES 


The at and batch commands read from standard input the commands to be 
executed at a later time. sh(1) provides different ways of specifying standard 
input. Within your commands, it may be useful to redirect standard output. 


This sequence can be used at a terminal: 
batch 
sort filename > outfile 
<control-D> (hold down ’control’ and depress ’D’) 


This sequence, which demonstrates redirecting standard error to a pipe, is useful 
in a shell procedure (the sequence of output redirection specifications is 


significant): 
batch < <! F 


sort filename 2>&1 >outfile | mail loginid 
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To have a job reschedule itself, invoke at from within the shell procedure, by 
“™ including code similar to the following within the shell file: 


echo "sh shellfile 


FILES 
/usr/lib/cron 
/usr/lib/cron/at.allow 
/usr/lib/cron/at.deny 
/usr/lib/cron/queue 
/usr/spool/cron/atyobs 


SEE ALSO 


"{ at 1900 thursday next week 


main cron directory 
list of allowed users 
list of denied users 
scheduling information 
spool area 


kill(1), mail(1), nice(1), ps(1), sh(1), sort(1) 
cron(1M) in the System Administrator’s Reference Manual 


DIAGNOSTICS 


Complains about various syntax errors and times out of range. 
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NAME 


ati - read and write ANSI format magnetic reel-to-reel tapes 


SYNOPSIS 


ati -i [eftv] [-F devname] [patterns] 


ati -o [exv] [-n [name]] [-F devname] [-d fset] [-b size] [-r size] [-L volid] [-c 
fsec] [-s Inum] [-q fnum] [-ebcdic | -ibm] 


DESCRIPTION 


The ati command reads and writes ANSI format tapes installed in a Small 
Computer Systems Interface (SCSI) reel-to-reel magnetic tape drive. 


NOTE: ati is intended for data exchange between U 5000/30/35/50/55 systems 
and non- Unisys systems. This should not be used in place of cpio(1) for data 
exchange between U 5000/30/35/50/55 systems. 


ati -i (in) copies the files, specified by pattems, from the tape, specified by 
devname, to the current directory. The ati command provides no directory 
support and all files are copied into the current directory. Filename patterns 
follow the name-generating notation of sh(1). If no filenames are given, all files 
are copied from the tape; that is, the default pattern is *. The ati command 
determines if the tape is encoded in EBCDIC or ASCII and uses the appropriate 
character set. If ati finds an existing file in the current directory with the same ~ 
name, the user is warned of the dilemma and has 15 seconds to terminate ati. If 
ati is not terminated, the file in the current directory is overwritten by the file on 
the tape. If the first file on the tape has a file section number greater than 1, ati 
appends the tape file data to the end of the existing file if one exists or issues a 
warning if the file does not exist. 


ati -o (out) reads filenames from the standard input and copies those files to the 
tape specified by devname. 


— OPTIONS 


b size The maximum block size to use on the tape (-o only). The size may be 
followed by k, b, or w to specify multiplication by 1024, 512, or 2, 
respectively. The default size is 512 bytes; the maximum is 64K bytes. 


cfsec The first file on the tape is a continuation (-o only). The fsec is the file 
section number in the HDR1 field for the first file on the tape. ati does 
not check the validity of fsec. This option is needed only if the user runs 
out of blank tapes and has to terminate the copy and continue it at a 
later time. 
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d fset 


The file set identification for the copied files (-o only). The default fset 
is the volume identification. 


Stop the copy operation at end of volume. The default is to stop the copy 
operation at the end of the file set. 


Negate the patterns; copy in all files with names that do not match any 
pattern (-i only). 


F devname 


h name 


q fnum 


r size 


s lInum 


Page 2 


The tape device to use. The default device name is /dev/rmt/Omyy. 


The volume identification for the tape (-o only). The default volume 
identification is 000000. 


The owner identification of a new tape (-o only). If mis not entered, ati 
skips to the logical end of data on the tape before adding new files. If n 

is entered, ati overwrites any existing data on the tape. The name cannot 
start with a hyphen character (-). 


The file sequence number of the first tape in the volume (-o only). Use 
with the c and s options for multi-volume tapes. 


The record size to use on the tape (-o only). The size may be followed 
by k, b, or w to specify multiplication by 1024, 512, or 2, respectively. 


- For fixed length records, this is the actual record size. The default is 
a record size equal to the block size. The record size must be an 
equal divisor of the block size. Records shorter than this size are 
padded with space characters; records longer than this size are split 
to fit the specified record size. 


- For variable length records, this is the maximum record size not 
including the 4-byte variable length indicator. The default and the 
maximum are 4 less than the block size. Records shorter than this 
size are not padded. Records longer than this size are split to fit the 
specified record size. 


Skip to the /nwmth character in the first file before writing on the tape 
(-o only). This option is used with the ¢ option to split a file across two 
or more tapes. ati does not check the validity of num. The user must 
take care to not create invalid tapes. 


Print a directory of the files on the tape (-i only). No copy operation 
occurs. If v is also entered, print the tape volume label and file 
information for each file on the tape. 
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V Print the names of all files to standard output as they are copied if a 
copy is occurring or print the volume label and file information if a 
directory print (see the t option) is occurring. 


x The tape contains fixed length records (-o only). The default is variable 
length records with a 4-byte decimal variable length indicator at the 
beginning of each record. 


ebcdic Write the tape in EBCDIC (-o only). The default is ASCII. 
ibm = Write the tape in IBM EBCDIC. This mapping corresponds better to 


some IBM train printers. 


FILES 
/dev/rmt/* 


EXAMPLES 
To copy all files on the tape in /dev/rmt/Omyy to the current directory, enter: 
ati -i 
To copy only file and file2 from the tape in /dev/rmt/Omyy to the current 
directory, enter: 
ati -i filel file2 


To enter a list of filenames from standard input of files to be copied to the tape 
in /dev/rmt/Omyy, enter: 


ati -o 


To copy a set of files using the list of filenames in filelist, to a tape in 
/dev/rmt/Omyy, with volume identification of 000100 in EBCDIC and 80 byte 
variable length records in 4K byte blocks, enter: 


ati -ov -n PAY1 -b 4k -r 80 -1 000100 -ebcdic < filelist 


RESTRICTIONS 
The ati command does not provide any support for UNIX file permissions and 
all files are given file permissions of 666. 


If the tape is not already in ANSI format, the -n option must be used when 
writing to the tape. 
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SEE ALSO 
cpio(1), find(1) 
ar(1) in the Programmer’s Reference Manual 
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NAME 
awk - pattern scanning and processing language 


SYNOPSIS 
awk [ -Fc | [ prog ] [ parameters ] [ files ] 


DESCRIPTION 
The awk command scans each input file for lines that match any of a set of 
patterns specified in prog. With each pattern in prog there can be an associated 
action that is performed when a line of a file matches the pattern. The set of 
patterns may appear literally as prog, or in a file specified as -f file. The prog 
string should be enclosed in single quotes (’) to protect it from the shell. 


Parameters, in the form x=... y=... etc., may be passed to awk. 


Files are read in order; if there are no files, the standard input is read. The 
filename - means the standard input. Each line is matched against the pattern 
portion of every pattern-action statement; the associated action is performed for 
each matched pattern. 


An input line is made up of fields separated by white space. (This default can be 
changed by using FS; see below). The fields are denoted $1, $2, ...; $0 refers to 
the entire line. 


A pattern-action statement has the form: 
pattern { action } 


A missing action means print the line; a missing pattern always matches. An 
action is a sequence of statements. A statement can be one of the following: 


if ( conditional ) statement [ else statement ] 
while ( conditional ) statement 

for ( expression ; conditional ; expression ) statement 
break 

continue 

{ [ statement ] ... } 

variable = expression 

print [ expression-list ] [ >expression ] 

printf format [ , expression-list ] [ > expression ] 
next # skip remaining patterns on this input line 
exit # skip the rest of the input 


Statements are terminated by semicolons, newlines, or right braces. An empty 
expression-list stands for the whole line. Expressions take on string or numeric 
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values as appropriate, and are built using the operators +, -, *, /, %, and 
concatenation (indicated by a blank). The C operators + +, --, + =, -=, *=, 
/=, and %= are also available in expressions. Variables may be scalars, array 
elements (denoted x[i]) or fields. Variables are initialized to the null string. 
Array subscripts may be any string, not necessarily numeric; this allows for a 
form of associative memory. String constants are quoted ("). 


The print statement prints its arguments on the standard output (or on a file if 
> expr is present), separated by the current output field separator, and 
terminated by the output record separator. The printf statement formats its 
expression list according to the format [see printf(3S) in the Programmer’s 
Reference Manual]. 


The built-in function /ength returns the length of its argument taken as a string, 
or of the whole line if no argument. There are also built-in functions exp, log, 
sqrt, and int. The last truncates its argument to an integer; substr(s, m,n) 
returns the n-character substring of s that begins at position m. The function 
sprintf (fmt, expr, expr, ...) formats the expressions according to the printf (3S) 
format given by fmt and returns the resulting string. 


Patterns are arbitrary Boolean combinations ( !, | |, &&, and parentheses) of 
regular expressions and relational expressions. Regular expressions must be 
surrounded by slashes and are as in egrep [see grep(1)]. Isolated regular 
expressions in a pattern apply to the entire line. Regular expressions may also 
occur in relational expressions. A pattern may consist of two patterns separated 
by a comma; in this case, the action is performed for all lines between an 
occurrence of the first pattern and the next occurrence of the second. 


A relational expression is one of the following: 


expression matchop regular-expression 
expression relop expression 


where a relop is any of the six relational operators in C, and a matchop is either 
~ (for contains) or !~ (for does not contain). A conditional is an arithmetic 
expression, a relational expression, or a Boolean combination of these. 


The special patterns BEGIN and END may be used to capture control before 
the first input line is read and after the last. BEGIN must be the first pattern, 
END the last. 
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A single character c may be used to separate the fields by starting the program 
with: 


BEGIN { FS = c } 
or by using the -Fc option. 


Other variable names with special meanings include NF, the number of fields in 
the current record; NR, the ordinal number of the current record; FILENAME, 
the name of the current input file; OFS, the output field separator (default 
blank); ORS, the output record separator (default newline); and OFMT, the 
output format for numbers (default %.6g). 


EXAMPLES 
Print lines longer than 72 characters: 


length > 72 
Print first two fields in opposite order: 
{ print $2, $1 } 
Add up first column, print sum and average: 


{s += $1 } 
END { print "sum is", s, " average is", s/NR } 


Print fields in reverse order: 
{ for (i = NF;i > 0; --i) print Si } 
Print all lines between start/stop pairs: 
/start/, /stop/ 

Print all lines whose first field is different from previous one: 
$1 != prev { print; prev = $1 } 
Print file, filling in page numbers starting at 5: 

/Page/ { $2 = n++4; } 
{ print } 
command line: awk -f program n=5 input 
SEE ALSO 


grep(1), nawk(1), sed(1) 
lex(1), printf(3S) in the Programmer’s Reference Manual 
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BUGS 
Input white space is not preserved on output if fields are involved. 


There are no explicit conversions between numbers and strings. To force an 


expression to be treated as a number add 0 to it; to force it to be treated as a 
string concatenate the null string (_ ) to it. 
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NAME 
banner - make posters 


SYNOPSIS 
banner strings 


DESCRIPTION 
The banner command prints its arguments (each up to 10 characters long) in 
large letters on the standard output. 


Internationalization 
This command has no international functionality. Non-ASCII characters 
specified in strings will not be output correctly. 


SEE ALSO 
echo(1) 
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NAME 

cr basename, dirname - deliver portions of pathnames 

“7 SYNOPSIS | 
basename string [ suffix | 
dirname string 


DESCRIPTION 
The basename command deletes any prefix ending in / and the suffix (if present 
in string) from string, and prints the result on the standard output. It is normally 
used inside substitution marks (* ~ ) within shell procedures. 


Dimame delivers all but the last level of the pathname in string. 


EXAMPLES 
The following example, invoked with the argument /usr/src/cmd/cat.c, compiles | 
the named file and moves the output to a filenamed cat in the current directory: 


cc $1 
mv a.out ~‘ basename $1 ’\.c’ * 
| ) The following example sets the shell variable NAME to /usr/srce/cmd: 


NAME= ~* dirname /usr/src/cmd/cat.c ~* 


SEE ALSO 
sh(1) 
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NAME 
be - arbitrary-precision arithmetic language | 


SYNOPSIS 
be [ -c ] [ -1 ] [ file ... ] 


DESCRIPTION 
The bc command is an interactive processor for a language that resembles C but 
provides unlimited precision arithmetic. It takes input from any files given, then 
reads the standard input. The bc(1) utility is actually a preprocessor for dc(1), 
which it invokes automatically unless the -c option is present. In this case the dc 
input is sent to the standard output instead. The options are as follows: 


-c Compile only. The output is sent to the standard output. 


-| Argument stands for the name of an arbitrary precision math library. 


The syntax for bc programs is as follows; L means letter a-z, E means expression, 
S means statement. 


Comments 
are enclosed in /* and */. 


Names 
sumple variables: L 
array elements: L [ E ] 
The words "ibase", "obase", and "scale" 


Other operands 
arbitrarily long numbers with optional sign and decimal point. 
(E) 
sqrt (E) 
length( E) number of significant decimal digits 
scale( E) number of digits right of decimal point 


LB Byway) 
Operators 
+ - * / % “~ (%is remainder; ~ is power) 
++ -- (prefix and postfix; apply to names) 
== <= Ss t= < > 


= s+ =. =% =/=% =” 


Statements 
E 
tee 
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u{E)S 

while (E)S 

for ( E;E:;E)S 
null statement 
break 

quit 


Function definitions 
define L(L,..., L) { 
MILO Liss Ls 
iw 
return (E ) 


Functions in -! math library 
s(x) sine 
c{x) cosine 
e(x) exponential 
I(x) log 
a(x) arctangent 
j(a,x) Bessel function 


All function arguments are passed by value. 


The value of a statement that is an expression is printed unless the main operator 
is an assignment. Either semicolons or newlines may separate statements. 
Assignment to scale influences the number of digits to be retained on arithmetic 
operations in the manner of dc(1). Assignments to ibase or obase set the input 
and output number radix respectively. 


The same letter may be used as an array, a function, and a simple variable 
simultaneously. All variables are global to the program. "Auto" variables are 
pushed down during function calls. When using arrays as function arguments or 
defining them as automatic variables, empty square brackets must follow the 
array name. 


EXAMPLES 

scale = 20 

define e(x){ 
auto a, b, c, 1, s 
a=1 
b=1 
s=1 
for(i=1; 1= =1;1+ +){ 
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a= a*x 
b = b*1 
~~ c = a/b 
if(c = = 0) return(s) 
s=stc 
} 
} 
defines a function to compute an approximate value of the exponential function 
and 


for(i=1; 1< =10;1+ +) e(i) 


prints approximate values of the exponential function of the first ten integers. 


FILES 
/usr/lib/lib.b mathematical library 
/usr/bin/dc — desk calculator proper 


SEE ALSO 


f~ dc(1) 
BUGS 
The bc command does not yet recognize the logical operators, && and | }. 
For statement must have all three expressions (E’s). 
Quit is interpreted when read, not when executed. 
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NAME 
bdiff - big diff 


SYNOPSIS 
bdiff file1 file2 [n] [-s] 


DESCRIPTION 
The bdiff command is used in a manner analogous to diff(1) to find which lines 
in two files must be changed to bring the files into agreement. Its purpose is to 
allow processing of files which are too large for diff. 


The parameters to bdiff are: 


filel (file2) 
The name of a file to be used. If filel (file2) is -, the standard input is read. 


n The number of line segments. The value of n is 3500 by default. If the 
optional third argument is given and it is numeric, it is used as the value for 
n. This is useful in those cases in which 3500-line segments are too large 
for diff, causing it to fail. 


-s_ Specifies that no diagnostics are to be printed by bdiff (silent option). 
Note, however, that this does not suppress possible diagnostic messages 
from diff(1), which bdiff calls. 


bdiff ignores lines common to the beginning of both files, splits the remainder of 
each file into n-line segments, and invokes diff upon corresponding segments. If 
both optional arguments are specified, they must appear in the order indicated 
above. 


The output of bdiff is exactly that of diff, with line numbers adjusted to account 
for the segmenting of the files (that is, to make it look as if the files had been 
processed whole). Note that because of the segmenting of the files, bdiff does 
not necessarily find a smallest sufficient set of file differences. 


FILES 


SEE ALSO 
diff(1), help(1) 


DIAGNOSTICS 
Use help(1) for explanations. 
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NAME 
bfs - big file scanner 


SYNOPSIS 
bfs [ - ] name 


DESCRIPTION 
The bfs command is (almost) like ed(1) except that it is read-only and processes 
much larger files. Files can be up to 1024K bytes and 32K lines, with up to 512 
characters, including newline, per line (255 for 16-bit machines). bfs is usually 
more efficient than ed(1) for scanning a file, since the file is not copied to a 
buffer. It is most useful for identifying sections of a large file where csplit(1) can 
be used to divide it into more manageable pieces for editing. 


Normally, the size of the file being scanned is printed, as is the size of any file 
written with the w command. The optional - suppresses printing of sizes. Input 
is prompted with * if P and a carriage return are typed, as in ed(1). Prompting 
can be turned off again by inputting another P and carriage return. Note that 
messages are given in response to errors if prompting is turned on. 


All address expressions described under ed(1) are supported. In addition, 
regular expressions may be surrounded with two symbols besides / and ?: > 
indicates downward search without wrap-around, and < indicates upward search 
without wrap-around. There is a slight difference in mark names: only the letters 
a through z may be used, and all 26 marks are remembered. 


The e, g, v, k, p, q, Ww, =, ! and null commands operate as described under ed(1). 
Commands such as ---, + + +-, + + + =, -12, and +4p are accepted. Note that 
1,10p and 1,10 both print the first ten lines. The f command only prints the name 
of the file being scanned; there is no remembered filename. The w command is 
independent of output diversion, truncation, or crunching (see the xo, xt and xc 
commands, below). The following additional commands are available: 


xf file 
Further commands are taken from the named file. When an end-of- 
file is reached, an interrupt signal is received or an error occurs, 
reading resumes with the file containing the xf. The xf commands 
may be nested to a depth of 10. 


xn __ List the marks currently in use (marks are set by the k command). 


xo [file | 
Further output from the p and null commands is diverted to the 
named file, which, if necessary, is created mode 666 (readable and 
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writable by everyone), unless your umask setting [see uwmask(1)] 


dictates otherwise. If file is missing, output is diverted to the , 
standard output. Note that each diversion causes truncation or Cal 
creation of the file. 

: label 


This positions a /abe/ in a command file. The /abel is terminated by 
newline, and blanks between the : and the start of the /abel are 
ignored. This command may also be used to insert comments into a 
command file, since labels need not be referenced. 


(.,. )xb/regular expression/label 
A jump (either upward or downward) is made to /abel if the 
command succeeds. It fails under any of the following conditions: 
1. Either address is not between 1 and §. 
2. The second address is less than the first. 
3. The regular expression does not match at least one line in 
the specified range, including the first and last lines. 


On success, . is set to the line matched and a jump is made to /abel. This Nas 
command is the only one that does not issue an error message on bad addresses, 

so it may be used to test whether addresses are bad before other commands are 
executed. Note that the command 


xb/ “~/ label 


is an unconditional jump. 
The xb command is allowed only if it is read from someplace other than a 
terminal. If it is read from a pipe only a downward jump is possible. 


xt number 
Output from the p and null commands is truncated to at most number 
characters. The initial number is 255. 


xv[ digit | [spaces | [value | 

The variable name is the specified digit following the xv. The commands xv5100 ; 

or xv5 100 both assign the value 100 to the variable 5. The command xv61,100p , 
assigns the value 1,100p to the variable 6. To reference a variable, put a % in 

front of the variable name. For example, using the above assignments for 

variables 5 and 6: 


1,%5p 
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1,%5 
%6 


all print the first 100 lines. 


2/%5/p 


would globally search for the characters 100 and print each line containing a 
match. To escape the special meaning of %, a \ must precede it. 


g/".*\%[cds}/p 


could be used to match and list lines containing printf of characters, decimal 
integers, or strings. 


Another feature of the xv command is that the first line of output from a UNIX | 
system command can be stored into a variable. The only requirement is that the 
first character of value be an !. For example: 


.w junk 

xv5!cat junk 

rm junk 

lecho "%5" 
xv6lexpr %6 + 1 


would put the current line into variable 5, print it, and increment the variable 6 
by one. To escape the special meaning of ! as the first character of value, | 
precede it with a \. | 


xv7\!date 
stores the value !date into variable 7. 
xbz /abel 
xbn label 
These two commands test the last saved return code from the execution of a 


UNIX system command (!command) or nonzero value, respectively, to the 
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specified label. The two examples below both search for the next five lines 
containing the string size. 


xv55 

: 1 

/size/ 

xvS!expr %5 - 1 
hf 0%5 != 0 ext 2 
xbn | 

xv45 

<q 

/size/ 

xv4lexpr %4-1 
lif 0%4 = 0 ext 2 
xbz | 


xe [switch | 

If switch is 1, output from the p and null commands is crunched; if switch is 0 it 
is not. Without an argument, xc reverses switch. Initially switch is set for no 
crunching. Crunched output has strings of tabs and blanks reduced to one blank 
and blank lines suppressed. 


Internationalization 
The bfs command can process ASCII characters as well as characters from 
supplementary code sets in the text. 


The bfs command can also recognize /abe/s containing characters from 
supplementary code sets for :, xb, xbn, and xbz commands. 


Regular expression searches are performed on characters, not on individual 
bytes. Refer to ed(1). 


The value designated by number with the xt command must be the number of 
displayed columns, not the number of characters or the number of EUC bytes. 


Marks set by the k command must be ASCII characters in the range of a to z, 
and all 26 marks are remembered. 


SEE ALSO 
csplit(1), ed(1), umask(1) 


DIAGNOSTICS 
? for errors in commands, if prompting is turned off. Self-explanatory error 
messages when prompting is on. 
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NAME 
o™ cal - print calendar 


SYNOPSIS 
cal [ [ month ] year ] 


DESCRIPTION 
The cal command prints a calendar for the specified year. If a month is also 
specified, a calendar just for that month is printed. If neither is specified, a 
calendar for the present month is printed. Year can be between 1 and 9999. The 
month is a number between 1 and 12. The calendar produced is that for 
England and the United States. 


EXAMPLES 
An unusual calendar is printed for September 1752. That is the month 11 days 
were skipped to make up for lack of leap year adjustments. To see this calendar, 
type: cal 9 1752 


BUGS 
i The year is always considered to start in January even though this is historically 
naive. ; 


Beware that "cal 83" refers to the early Christian era, not the 20th century. 
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NAME 
calendar - reminder service 


SYNOPSIS 
calendar [ - | 


DESCRIPTION 
The calendar command consults the file calendar in the current directory and 
prints out lines that contain today’s or tomorrow's date anywhere in the line. 
Most reasonable month-day dates such as "Aug. 24," "august 24," "8/24," etc., are 
recognized, but not "24 August" or "24/8". On weekends "tomorrow" extends 
through Monday. 


When an argument is present, calendar does its job for every user who has a file 
calendar in his or her login directory and sends them any positive results by 
mail(1). Normally this is done daily by facilities in the UNIX operating system. 


FILES 
/usr/lib/calprog to figure out today’s and tomorrow’ dates 


/etc/passwd 
/tmp/cal* 


SEE ALSO 
mail(1) 


BUGS 
Your calendar must be public information for you to get reminder service. 


calendar’s extended idea of "tomorrow’ does not account for holidays. 
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NAME 
cancel - cancel requests to an LP line printer 


SYNOPSIS 
cancel [ ids } [ printers ] 


DESCRIPTION 
The cancel command cancels line printer requests that were made by the /p(1) 
command. The command line arguments may be either request ids (as returned 
by Jp(1)) or printer names. For a complete list, see /pstat(1). Specifying a request 
id cancels the associated request even if it is currently printing. Specifying a 
printer cancels the request which is currently printing on that printer. In either 
case, the cancellation of a request that is currently printing frees the printer to 
print its next available request. 


FILES 
/usr/spool/1p/* 


SEE ALSO 
enable(1), Ip(1), Ipstat(1) 
accept(1M), lpadmin(1M), Ipsched(1M) in the Administrator’s Reference 
~ Manual 
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NAME 
\ i’ cat - concatenate and print files 


SYNOPSIS 
cat [ -u ] [ -s ] [ -v [-t] [-e] ] file ... 


DESCRIPTION 
The cat command reads each file in sequence and writes it on the standard 
output. Thus: 


cat file 
prints the file, and: 
cat filel file2 > file3 
concatenates the first two files and places the result on the third. 


If no input file is given, or if the argument - is encountered, cat reads from the 
standard input file. 


i The following options apply to cat. 
-u_—« The output is not buffered. (The default is buffered output.) 
-s__ cat is silent about non-existent files. 


-y Causes non-printing characters (with the exception of tabs, newlines and 
form-feeds) to be printed visibly. Control characters are printed ~X 
(control-x); the DEL character (octal 0177) is printed ~?. Non-ASCII 
characters (with the high bit set) are printed as M-x, where x 1s the | 
character specified by the seven low order bits. | 


When used with the -v option, the following options may be used. 
-t | Causes tabs to be printed as ~I’s. 


-e Causes a $ character to be printed at the end of each line (prior to the 
newline). 


The -t and -e options are ignored if the -v option is not specified. 


tt Internationalization 
| The cat command can read and write characters from supplementary code sets. 
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WARNINGS 
Command formats such as 
cat filel file2 > filel 
cause the original data in file] to be lost; therefore, take care when using shell 
special characters. 


SEE ALSO 
cp(1), pg(1), pr(1) 
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NAME 
cd - change working directory 


SYNOPSIS 
cd [ directory ] 


DESCRIPTION 
If directory is not specified, the value of shell parameter $HOME is used as the 
new working directory. If directory specifies a complete path starting with /, ., .., 
directory becomes the new working directory. If neither case applies, cd tries to 
find the designated directory relative to one of the paths specified by the 
$CDPATH shell variable. $CDPATH has the same syntax as, and similar 
semantics to, the $PATH shell variable. cd must have execute (search) 
permission in directory. 


Because a new process is created to execute each command, cd would be 
ineffective if it were written as a normal command; therefore, it is recognized and 
is internal to the shell. 


SEE ALSO 


pwd(1), sh(1) 
chdir(2) in the Programmer’s Reference Manual 
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NAME 
chfn - change GCOS job number for user 


SYNOPSIS 
chfn [ oldname[ newname ] | 


DESCRIPTION 
The chfn command changes the GCOS job number field for a particular user as 


displayed in /etc/passwd. 


OPTIONS 
oldname The oldname option defines the login name of the user whose login 
name is being changed. If the o/dname option is not given, the login 
name 1s changed for the current login user. 


If a password exists for a login name, the user is prompted to enter 
the correct password associated with the login name being changed. 


newname The newname option defines the new login name for the defined user 
after this command is performed. If the newname option is not given, 
the current login name is displayed and the user is prompted to enter 
a new login name. 


SEE ALSO 
chsh(1), who(1) 


DIAGNOSTICS 
If problems occur with the password file and locking it, the chfn(1) command 


reports the problems and then exits. 


RESTRICTIONS 
newname is limited to 128 characters. Any additional characters are ignored. 
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NAME 


chmod - change mode 


SYNOPSIS 


chmod mode file ... 
chmod mode directory ... 


DESCRIPTION 


The permissions of the named files or directories are changed according to mode, 
which may be symbolic or absolute. Absolute changes to permissions are stated 
using octal numbers: 


| chmod nnn file(s) 
where n is a number from 0 to 7. Symbolic changes are stated using mnemonic 
characters: 


chmod a operator b file(s) 


where a is one or more characters corresponding to user, group, or other; where 
operator is +, -, and =, signifying assignment of permissions; and where D is one 
or more characters corresponding to type of permission. 

An absolute mode is given as an octal number constructed from the OR of the 
following modes: 


4000 set user ID on execution 

20#0 set group ID on execution if # is 7, 5, 3, or 1 
enable mandatory locking if # is 6, 4, 2, or 0 

1000 sticky bit is turned on ((see chmod (2)) 

0400 read by owner 

0200 write by owner 

0100 execute (search in directory) by owner 

0070 read, write, execute (search) by group 

0007 read, write, execute (search) by others 


Symbolic changes are stated using letters that correspond both to access classes 
and to the individual permissions themselves. Permissions to a file may vary 
depending on your user identification number (UID) or group identification 
number (GID). 
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Permissions are described in three sequences each having three characters: 


User Group Other oo’ 
rwxX  rwx = rwx a 


This example (meaning that user, group, and others all have reading, writing, and 
execution permission to a given file) demonstrates two categories for granting 
permissions: the access class and the permissions themselves. 


Thus, to change the mode of a file’s (or directory’s) permissions using chmod’s 
symbolic method, use the following syntax for mode: 


[ who | operator [ permission(s) ], ... 
A command line using the symbolic method would appear as follows: 
chmod g+rw file 
This command would make file readable and writable by the group. 


The who part can be stated as one or more of the following letters: 


u user’s permissions x j 
g group’s permissions 
0 others permissions | 


The letter a (all) is equivalent to ugo and is the default if who is omitted. | 


Operator can be + to add permission to the file’s mode, - to take away 
permission, or = to assign permission absolutely. (Unlike other symbolic 
operations, = has an absolute effect in that it resets all other bits.) Omitting 
permission is only useful with = to take away all permissions. 


Permission is any compatible combination of the following letters: 
r reading permission 

writing permission 

execution permission 

user or group set-ID is turned on 

sticky bit is turned on 

mandatory locking occurs during access 


—ert en KH SF 


Multiple symbolic modes separated by commas may be given, though no spaces a 
may intervene between these modes. Operations are performed in the order 

given. Multiple symbolic letters following a single operator cause the 

corresponding operations to be performed simultaneously. The letter s is only 
meaningful with u or g, and t only works with u. 
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Mandatory file and record locking (1) refers to a file’s ability to have its reading 
or writing permissions locked while a program is accessing that file. It is not 
possible to permit group execution and enable a file to be locked on execution at 
the same time. In addition, it is not possible to turn on the set-group-ID and 
enable a file to be locked on execution at the same time. The following 
examples, 


chmod g+x, +1 file 
chmod g+s, +1 file 


are, therefore, illegal usages and elicit error messages. 


Only the owner of a file or directory (or the superuser) may change a file’s mode. 
Only the superuser may set the sticky bit. In order to turn on a file’s set-group- 
ID, your own group ID must correspond to the file’s, and group execution must 
be set. 


EXAMPLES 
chmod a-x file 


chmod 444 file 


The first examples deny execution permission to all. The absolute (octal) 
example permits only reading permissions. 


chmod go+rw file 
chmod 606 file 

These examples make a file readable and writable by the group and others. 
chmod +1 file 


This causes a file to be locked during access. 


chmod =rwxg+s file 
chmod 2777 file 


eo These last two examples enable all to read, write, and execute the file; and they 
turn on the set group-ID. 


SEE ALSO 
Is(1) 
chmod(2) in the Programmer’s Reference Manual 
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NAME 
chown, chgrp - change owner or group 


SYNOPSIS 
chown owner file ... 


chown owner directory ... 
chgerp group file ... 
chgrp group directory ... 


DESCRIPTION 
The chown command changes the owner of the files or directories to owner. The 


owner may be either a decimal user ID or a login name found in the password 
file. 


chgrp changes the group ID of the files or directories to group. The group may be 
either a decimal group ID or a group name found in the group file. 


If either command is invoked by other than the superuser, the set-user-ID and 
f set-group-ID bits of the file mode, 04000 and 02000 respectively, are cleared. 


Only the owner of a file (or the superuser) may change the owner or group of 
that file. 


FILES 
/etc/passwd 
/etc/group 


NOTES 
In a Remote File Sharing environment, you may not have the permissions that the 
output of the Is -1 command leads you to believe. 


SEE ALSO 
chmod(1) 
chown(2), group(4), passwd(4) in the Programmer’s Reference Manual 


a 
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NAME 
clear - clear terminal screen 


SYNOPSIS 
clear 


DESCRIPTION 
The clear command clears your screen if possible. 


clear looks in the environment for the terminal type and then in /usr/lib/terminfo 
to determine how to clear the screen. 


FILES 
/usr/lib/terminfo terminal capability data base 
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NAME 
cmp - compare two files 


SYNOPSIS 
cmp [ -I ] [ -s | filel file2 


DESCRIPTION 
The two files are compared. (If file] is -, the standard input is used.) Under 
default options, cmp makes no comment if the files are the same; if they differ, it 
announces the byte and line number at which the difference occurred. If one file 
is an initial subsequence of the other, that fact is noted. 


Options: 


-] Print the byte number (decimal) and the differing bytes (octal) for each 
difference. 


-S Print nothing for differing files; return codes only. 


SEE ALSO 
comm(1), diff(1) 


DIAGNOSTICS 
Exit code 0 is returned for identical files, 1 for different files, and 2 for an 
inaccessible or missing argument. 
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NAME 
col - filter reverse line-feeds 


SYNOPSIS 
col [-b] [-f] [-x] [-p] 


DESCRIPTION 
The col command reads from the standard input and writes onto the standard 
output. It performs the line overlays implied by reverse line feeds (ASCII code 
ESC-7), and by forward and reverse half-line-feeds (ESC-9 and ESC-8). col is 
particularly useful for filtering multicolumn output made with the .rt command of 
nroff and output resulting from use of the tb/(1) preprocessor. 


If the -b option is given, co/ assumes that the output device in use is not capable 
of backspacing. In this case, if two or more characters are to appear in the same 
place, only the last one read will be output. 


Although co/ accepts half-line motions in its input, it normally does not emit 
them on output. Instead, text that would appear between lines is moved to the 
next lower full-line boundary. This treatment can be suppressed by the -f (fine) 
option; in this case, the output from co/ may contain forward half-line-feeds 
(ESC-9), but still does not contain either kind of reverse line motion. 


Unless the -x option is given, col converts white space to tabs on output wherever 
possible to shorten printing time. 


The ASCII control characters SO (\017) and SI (\016) are assumed by col to 
start and end text in an alternate character set. The character set to which each 
input character belongs is remembered, and on output SI and SO characters are 
generated as appropriate to ensure that each character is printed in the correct 
character set. 


On input, the only control characters accepted are space, backspace, tab, return, 
newline, SI, SO, VT (\013), and ESC followed by 7, 8, or 9. The VT character is 
an alternate form of full reverse line-feed, included for compatibility with some 
earlier programs of this type. All other non-printing characters are ignored. 


Normally, col ignores any escape sequences unknown to it that are found in its 
input; the -p option may be used to cause col to output these sequences as 
regular characters, subject to overprinting from reverse line motions. The use of 
this option is highly discouraged unless the user is fully aware of the textual 
position of the escape sequences. 
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SEE ALSO 
nroff(1), tbl(1) in the DOCUMENTER’S WORKBENCH reference manuals i~ | 
| 
NOTES 


The input format accepted by co/ matches the output produced by nroff with 
either the -T37 or -TIp options. Use -T37 (and the -f option of co/) if the 
ultimate disposition of the output of co/ is a device that can interpret half-line 
motions, and -Tlp otherwise. 


BUGS 
Cannot back up more than 128 lines. 


Allows at most 800 characters, including backspaces, on a line. 


Local vertical motions that would result in backing up over the first line of the 
document are ignored. As a result, the first line must not have any superscripts. 
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NAME 
i. comm - select or reject lines common to two sorted files 


SYNOPSIS 
comm [ - [ 123 ] | file1 file2 


DESCRIPTION 
The comm command reads file] and file2, which should be ordered in ASCII 
collating sequence [see sort(1)], and produces a three-column output: lines only 
in file1; lines only in file2; and lines in both files. The filename - means the 
standard input. 


Flags 1, 2, or 3 suppress printing of the corresponding column. Thus comm -12 
prints only the lines common to the two files; comm -23 prints only lines in the 
first file but not in the second; comm -123 prints nothing. 

SEE ALSO 
cmp(1), diff(1), sort(1), uniq(1) 
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NAME 
compress, uncompress, zcat - compress and expand data 


SYNOPSIS 
compress [-f -F J[ -v]{ -c]J[-V][ -b bits ] 


[ -q ]{ -n J[ -C ][ name ... ] 


uncompresss [ -f ][ -v ][ -c ]{ -VI[ -q J[ -n ] 
[ -C ][ name ... ] 


zcat [ -V ][ name ... ] 


DESCRIPTION 
The compress command reduces the size of one or more specified files. 
Whenever possible, each file is replaced by one with the extension .Z, while 
keeping the same ownership modes, access, and modification times. If no files 
are specified, the standard input is compressed to the standard output. 
Compressed files can be restored to their original form using uncompress or zcat. 


fc OPTIONS 

' -f | -F 
Force compression of name. This is useful for compressing an entire 
directory, even if some of the files do not actually shrink. If -f is not given 


and compress is run in the foreground, the user is prompted as to whether 
an existing file should be overwritten. 


-c Make compress and uncompress write to the standard output; no files are 
changed. The nondestructive behavior of zcat is identical to that of 
uncompress -c. 


-b compress uses the modified Lempel-Ziv algorithm popularized in A 
Technique for High Performance Data Compression, Terry A. Welch, JEEE 
Computer, vol. 17, no. 6 (June 1984), pp. 8-19. Common substrings in the 
file are first replaced by 9-bit codes 257 and up. When code 512 is 
reached, the algorithm switches to 10-bit codes and continues to use more 
bits until the limit specified by the -b flag is reached (default 16). bits must 
be between 9 and 16. The default can be changed in the source to allow 

c™ compress to be run on a smaller machine. 


After the bits limit is attained, compress periodically checks the compression 
ratio. If it is increasing, compress continues to use the existing code dictionary. 
However, if the compression ratio decreases, compress discards the table of 


UP-13525.1 V1 Page 1 


COMPRESS (1) 


substrings and rebuilds it from scratch. This allows the algorithm to adapt to the 
next "block" of the file. 


NOTE: The -b flag is omitted for uncompress since the bits parameter specified 
during compression is encoded within the output, along with a magic number to 
ensure that neither decompression of random data nor recompression of 
compressed data is attempted. 


The amount of compression obtained depends on the size of the input, the 
number of bits per code, and the distribution of common substrings. Typically, 
text such as source code or English is reduced by 50-60%. Compression is 
generally much better than that achieved by Huffman coding (as used in pack), 
or adaptive Huffman coding (compact), and takes less time to compute. 


-vy Print a message indicating the percentage of reduction for each file 
compressed. 


-V___‘ Print the current version and compile options on stderr. 

-q Runin the quiet mode. Do not print compression statistics. 

-n Do not use 3-byte magic number header (for compatibility with old files). 
-C Do not use block compression (for compatibility with old files). 


RETURN CODES 
Exit status is normally 0; if the last file is larger after (attempted) compression, 
the status is 2; if an error occurs, exit status is 1. 


SEE ALSO 
pack(1) 


DIAGNOSTICS 
Usage: compress [-fFvcVqnC] |[-b maxbits] [file ...] 
Invalid options were specified on the command line. 


Missing maxbits 
Maxbits must follow -b. 


file : not in compressed format 
The file specified to uncompress has not been compressed. 


file : compressed with xx bits, can only handle yy bits 
File was compressed by a program that could deal with more bits than the 
compress code on this machine. Recompress the file with smaller bits. 
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file : already has .Z suffix - no change 
oo The file is assumed to be already compressed. Rename the file and try 
| } again. 


file : filename too long to tack on .Z 
The file cannot be compressed because its name is longer than 12 
characters. Rename and try again. This message does not occur on BSD 
systems. 


file already exists; do you wish to overwrite y orn ? 
Respond "y" if you want the output file to be replaced; "n" if not. 


uncompress: corrupt input 
A SIGSEGV violation was detected which usually means that the input file 
has been corrupted. 


Compression: "xx.xxTo" 
Percentage of the input saved by compression. (Relevant only for -v.) 


- not a regular file: unchanged 
aN When the input file is not a regular file, (e.g., a directory), it is left 
| ) unaltered. 


- has xx other links: unchanged 
The input file has links; it is left unchanged. See In(1) for more 
information. 


- file unchanged 
No savings is achieved by compression. The input remains virgin. 


RESTRICTIONS 
Although compressed files are compatible between machines with large memory, 


-b12 should be used for file transfer to architectures with a small process data 
space (64KB or less) 
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NAME 


cp, In, mv - copy, link or move files 


SYNOPSIS 


cp filel [ file2 ...] target 
In [ -f | filel [ file2 ...] target 
mv [ -f | filel [ file2 ...] target 


DESCRIPTION 


The file file] is copied (linked, moved) to target. Under no circumstance can 
filel and target be the same (take care when using sh(1) metacharacters). If 
target is a directory, then one or more files are copied (linked, moved) to that 
directory. If target is a file, its contents are destroyed. 


If mv or In determines that the mode of target forbids writing, it prints the mode 
[see chmod (2)], ask for a response, and read the standard input for one line; if 
the line begins with y, the mv or /n occurs, if permissable; if not, the command 
exits. When the -f option is used or if the standard input is not a terminal, no 
questions are asked and the mv or In is done. 


Only mv allows filel to be a directory, in which case the directory rename occurs 
only if the two directories have the same parent; file] is renamed target. If filel is 
a file and target is a link to another file with links, the other links remain and 
target becomes a new file. 


When using cp, if target is not a file, a new file is created which has the same 
mode as file] except that the sticky bit is not set unless you are superuser; the 
owner and group of target are those of the user. If target is a file, copying a file 
into target does not change its mode, owner, nor group. The last modification 
time of target (and last access time, if target did not exist) and the last access time 
of filel are set to the time the copy was made. If target is a link to a file, all links 
remain and the file is changed. 


SEE ALSO 


chmod(1), cpio(1), rm(1) 


WARNINGS 


In does not link across file systems. This restriction is necessary because file 
systems can be added and removed. 


BUGS 


If file] and target lie on different file systems, mv must copy the file and delete 
the original. In this case any linking relationship with other files is lost. 
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NAME 
cpio - copy file archives in and out 


SYNOPSIS 
cpio -o[ acBvV] [-Cbufsize |] [-Mmessage] <name-list >file 


cpio -o[ acBvV] [-Ofile | [-Cbufsize |] [-Mmessage| <name-list 
cpio -i[ BcdmrtuvVfsSb6k] [-Cbufsize ] [-Mmessage] [pattem ...| <file 
cpio -i[ BedmrtuvVfsSb6k] [-Ifile | [-Cbufsize | [-Mmessage] [pattem ... ] 
cpio -p[adimuvV] directory <name-iist 

DESCRIPTION 
cpio -o (copy out) reads the standard input to obtain a list of pathnames and 


copies those files onto the standard output together with pathname and status 
information. Output is padded to a 512-byte boundary by default. 


cpio -i (copy in) extracts files from the standard input, which is assumed to be 
the product of a previous cpio -o. Only files with names that match pattems are 
eo selected. pattems are regular expressions given in the filename-generating 
| | notation of sh(1). In patterns, the meta-characters ?, *, and [...] match the 
slash (/) character, and the backslash (\) is an escape character. A ! meta- 
character means not. For example, the !abc* pattern would exclude all files that 
begin with abc. 


Multiple pattems may be specified but, if none are, the default for patterns is the 
* character (i.e., select all files). Each pattem must be enclosed in double quotes 
otherwise the name of a file in the current directory is used. Extracted files are 
conditionally created and copied into the current directory tree based upon the 
options described below. The permissions of the files are those of the previous 
cpio -o. The owner and group of the files are that of the current user unless the 
user is superuser, in which case cpio retains the owner and group of the files of 
the previous cpio -o. | 


NOTE: If cpio -i tries to create a file that already exists and the existing file is 
the same age or newer, cpio outputs a warning message and does not replace the 
en file. (The -u option can be used to unconditionally overwrite the existing file.) | 


cpio -p (pass) reads the standard input to obtain a list of pathnames of files that 
are conditionally created and copied into the destination directory tree based 
upon the options described below. 


| 
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OPTIONS 


-a 


-b 


-B 


Reset access times of input files after they have been copied. Access times 
are not reset for linked files when cpio -pla is specified. 


Reverse the order of the bytes within each word. Use only with the -i 
option. 


Input/output is to be blocked 5,120 bytes to the record. The default buffer 
size is 512 bytes when this and the C options are not used. -B does not 
apply to the pass option. -B is meaningful only with data directed to, or 
from, a character special device (e.g., /dev/rmt/Oxyy). 


Write header information in ASCII character form for portability. Always 
use this option when origin and destination machines are different types. 


-C bufsize 


-k 


4 


-m 


Page 2 


Input/output is to be blocked bufsize bytes to the record, where bufsize is 
replaced by a positive integer. The default buffer size is 512 bytes when 
this and the B options are not used. -C does not apply to the pass option. 
-C is meaningful only with data directed to, or from, a character special 
device (e.g., /dev/rmt/Oxyy). 


directories are to be created as needed. 


Copy in all files except those in pattems. See the paragraph on cpio -i for a 
description of pattems. 


Read the contents of file as input. If file is a character special device, when 
the first medium is full, replace it and type a carriage return to continue to 
the next medium. Use only with the -i option. 


Attempt to skip corrupted file headers and I/O errors that may be 
encountered. If you want to copy files from a medium that is corrupted or 
out of sequence, this option lets you read only those files with good 
headers. For cpio archives that contain other cpio archives, if an error is 
encountered, cpio may terminate prematurely. cpio finds the next good 
header, which may be one for a smaller archive, and terminates when the 
smaller archive’s trailer is encountered. Used only with the -i option. 


Whenever possible, link files rather than copying them. Used only with the 
-p option. 


Retain previous file modification time. This option is ineffective on 
directories that are being copied. 
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-M message 
Define a message to use when switching media. When you use the -O or -I 
f ‘\ options and specify a character special device, you can use this option to 


define the message that is printed when you reach the end of the medium. 
One %d can be placed in the message to print the sequence number of the 
next medium needed to continue. 


-O file 
Direct the output of cpio to file. If file is a character special device, when 
the first medium is full, replace it and type a carriage return to continue to 
the next medium. Use only with the -o option. 


-r__ Interactively rename files. If the user types a null line, the file is skipped. 
If the user types a . (dot), the original pathname is copied. (Not available 
with cpio -p.) 


-S_ swap bytes within each half word. Use only with the -i option. 
-S Swap halfwords within each word. Use only with the -i option. 
-t Print a Table of Contents of the input. No files are created. 


ill -u- Copy unconditionally. Normally, an older file does not replace a newer file 
with the same name. 


-v verbose: cause a list of filenames to be printed. When used with the -t 
option, the Table of Contents looks like the output of an Is -l command 
[see Js(1)]. 


-V_ Special Verbose: print a dot for each file seen. Useful to assure the user 
that cpio is working without printing out all filenames. 


-6 Process an old (i.e. UNIX System Sixth Edition format) file. Use only with 
the -i option. 


NOTE: cpio assumes four-byte words. 


If cpio reaches end of medium (end of a flexible disk, for example) when writing 
to (-o) or reading from (-i) a character special device, and -O and -I are not 
used, cpio prints the message: 


6 \ If you want to go on, type device/filename when ready. 


To continue, you must replace the medium and type the character special device 
name (/dev/rfdsk/0s0, for example) and carriage return. You may want to 
continue by directing cpio to use a different device. For example, if you have two 
flexibie drives you may want to switch between them so cpio can proceed while 
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you are changing the flexible disks. (A carriage return alone causes the cpio 
process to exit.) 


Internationalization 
The cpio command can process files containing characters from supplementary 
code sets. In pattern processing using metacharacters, matching is performed on 
characters, not bytes. 


The message with the -M option can include characters from supplementary code 
sets. 


EXAMPLES 
When standard input is directed through a pipe to cpio -o, it groups the files so 
they can be directed (>) to a single file (../newfile). The c option makes sure 
that the file is portable to other machines. Instead of /s(1), you could use find(1), 
echo(1), cat(1), etc., to pipe a list of names to cpio. You could direct the output 
to a device instead of a file. 


Is | cpio -oc > ../newfile 


cpio -i uses the output file of cpio -o (directed through a pipe with cat in the 
example), extracts those files that match the patterns (memo/al, memo/b*), 
creates directories below the current directory as needed (-d option), and places 
the files in the appropriate directories. The c option is used when the file is 
created with a portable header. If no patterns were given, all files from newfile 
would be placed in the directory. 


cat newfile | cpio -icd 'memo/al" 'memo/b*" 


cpio -p takes the filenames piped to it and copies or links (-1 option) those files 
to another directory on your machine (newdir in the example). The -d option 
creates directories as needed. The -m option retains the modification time. (It is 
important to use the -depth option of find(1) to generate pathnames for cpio. 
This eliminates problems cpio could have trying to create files under read-only 
directories.) 


find . -depth -print | cpio -pdimv newdir 


SEE ALSO 
cat(1), echo(1), find(1), Is(1), tar(1) 
ar(1) in the Programmer’s Reference Manual 


Page 4 UP-13525.1 V1 


CPIO(1) 


NOTES 
1) Pathnames are restricted to 256 characters. 


} 2) Only the superuser can copy special files. 
3) Blocks are reported in 512-byte quantities. 


4) Ifa file has 000 permissions, contains more than 0 characters of data, and the 
user is not root, the file is not saved or restored. 
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nena ae 


[This page left blank.] 
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NAME 
™ crontab - user crontab file 


SYNOPSIS 
crontab [file] | 
crontab -r | 
crontab -| 


DESCRIPTION 
The crontab command copies the specified file, or standard input if no file is 
specified, into a directory that holds all users’ crontabs. The -r option removes a 
user’s crontab from the crontab directory. crontab -l| lists the crontab file for the 
invoking user. 


Users are permitted to use crontab if their names appear in the file 

/usr/lib/cron/cron.allow. If that file does not exist, the file /usr/lib/cron/cron.deny 

is checked to determine if the user should be denied access to crontab. If neither 

file exists, only root is allowed to submit a job. If cron.allow does not exist and 

cron.deny exists but is empty, global usage is permitted. The allow/deny files 
o~ consist of one user name per line. 


A crontab file consists of lines of six fields each. The fields are separated by 
spaces or tabs. The first five are integer patterns that specify the following: 


minute (0-59), 

hour (0-23), 

day of the month (1-31), 

month of the year (1-12), 

day of the week (0-6 with 0 = Sunday). 


Each of these patterns may be either an asterisk (meaning all legal values) or a 
list of elements separated by commas. An element is either a number or two 
numbers separated by a minus sign (meaning an inclusive range). Note that the 
specification of days may be made by two fields (day of the month and day of the 
week). If both are specified as a list of elements, both are adhered to. For 
example, 0 0 1,15 * 1 would run a command on the first and fifteenth of each 

~*~ month, as well as on every Monday. To specify days by only one field, the other 

| field should be set to * (for example, 0 0 * * 1 would run a command only on 

Mondays). 


The sixth field of a line in a crontab file is a string that is executed by the shell at 
the specified times. A percent character in this field (unless escaped by \) is 
translated to a newline character. Only the first line (up to a % or end of line) 
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of the command field is executed by the shell. The other lines are made available 
to the command as standard input. 


The shell is invoked from your $HOME directory with an arg0 of sh. Users who 
desire to have their .profile executed must explicitly do so in the crontab file. 
Cron supplies a default environment for every shell, defining HOME, 
LOGNAME, SHELL(=/bin/sh), and PATH(=:/bin:/usr/bin:/usr/lbin). 


If you do not redirect the standard output and standard error of your commands, 
any generated output or errors are mailed to you. 


FILES 
/usr/lib/cron main cron directory 
/usr/spool/cron/crontabs spool area 
/usr/lib/cron/log accounting information 
/usr/lib/cron/cron.allow list of allowed users 
/usr/lib/cron/cron.deny list of denied users 
SEE ALSO 
sh(1) 


cron(1M) in the System Administrator’s Reference Manual 


WARNINGS 
If you inadvertently enter the crontab command with no argument(s), do not 
attempt to get out with a CTRL-d. This causes all entries in your crontab file to 
be removed. Instead, exit with a DEL. | 
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NAME 
c™ crypt - encode/decode 


SYNOPSIS 
crypt [ password ] 
crypt [-k] 


DESCRIPTION 
The crypt command reads from the standard input and writes on the standard 
output. The password is a key that selects a particular transformation. If no 
argument is given, crypt demands a key from the terminal and turns off printing 
while the key is being typed in. If the -k option is used, crypt uses the key 
assigned to the environment variable CRYPTKEY. crypt encrypts and decrypts 
with the same key: 


crypt key <clear >cypher 
crypt key <cypher | pr 


Files encrypted by crypt are compatible with those treated by the editors ed(1), 
rr edit(1), ex(1), and w(1) in encryption mode. 


The security of encrypted files depends on three factors: the fundamental 
method must be hard to solve; direct search of the key space must be infeasible; 
"sneak paths" by which keys or clear text can become visible must be minimized. 


crypt implements a one-rotor machine designed along the lines of the German 
Enigma, but with a 256-element rotor. Methods of attack on such machines are 
known, but not widely; moreover the amount of work required is likely to be 
large. 


The transformation of a key into the internal settings of the machine is 
deliberately designed to be expensive, i.e., to take a substantial fraction of a 
second to compute. However, if keys are restricted to (say) three lower-case 
letters, then encrypted files can be read by expending only a substantial fraction 
of five minutes of machine time. 


If the key is an argument to the crypt command, it is potentially visible to users 
executing ps(1) or a derivative. The choice of keys and key security are the most 


™ vulnerable aspect of crypt. 


FILES 
/dev/tty for typed key 


SEE ALSO 
ed(1), edit(1), ex(1), makekey(1), ps(1), stty(1), vi(1) 


UP-13525 V1 R1 Page 1 


CRYPT (1) 


WARNINGS 
This command is provided with the Crypt Utilities, which is only available in the : 
United States. If two or more files encrypted with the same key are concatenated a 
and an attempt is made to decrypt the result, only the contents of the first of the 
original files will be decrypted correctly. 


BUGS 
If output is piped to nvoff and the encryption key is not given on the command 
line, crypt can leave terminal modes in a strange state [see stty(1)]. 
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NAME 
rn csh - a shell (command interpreter) with C-like syntax 


SYNOPSIS 
csh [ -cefinstvVxX ] [ arg... ] 


DESCRIPTION 
The csh shell is a command language interpreter incorporating a history 
mechanism and a C-like syntax. 


An instance of csh begins by executing commands from the file .cshrc in the home 
directory of the invoker. If this is a login shell, csh also executes commands from 
the file ./ogin there. It is typical for users on terminals to put the command stty 
crt in their .Jogin file. 


In the normal case, the shell then begins reading commands from the terminal, 
prompting with %. Processing of arguments and the use of the shell to process 
files containing command scripts is described later. 


The shell then repeatedly performs the following actions: a line of command 

ite input is read and broken into words. This sequence of words is placed on the 
command history list and parsed. Then each command in the current line is 
executed. 


When a login shell terminates, it executes commands from the file .Jogout in the 
user home directory. 


LEXICAL STRUCTURE 
The shell splits input lines into words at blanks and tabs with the following 
exceptions. The characters &, |, ;, <, >, (, and ) form separate words. If 
doubled in single quotation marks, as ’&&’,’} |’,"< <’ or’> >’ these pairs 
form single words. These parser metacharacters may be made part of other 
words, or their special meaning may be prevented, by preceding them with a 
backslash, \. A newline preceded by a \ is equivalent to a blank. It is usually 
necessary to use the backslash to escape the parser metacharacters when you 
want to use them literally rather than as metacharacters. 


Strings enclosed in matched pairs of quotation marks, either single or double 
r~ quotation marks, form parts of a word. Metacharacters in these strings, including 
| blanks and tabs, do not form separate words. Such quotations have semantics to 
be described subsequently. Within pairs of single or double quotation marks a 
newline (carriage return) preceded by a \ gives a true newline character. This is 
used to set up a file of strings separated by newlines, as for fgrep(1). 
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When the shell input is not a terminal, the character # introduces a comment 
which continues to the end of the input line. It is prevented from having this 
special meaning when preceded by \ or if bracketed by a pair of single or double 
quotation marks. 


COMMANDS 
A simple command is a sequence of words, the first of which specifies the 
command to be executed. A simple command or a sequence of simple 
commands separated by } characters forms a pipeline. The output of each 
command in a pipeline is connected to the input of the next. Sequences of 
pipelines may be separated by semicolons (;), and are then executed sequentially. 
A sequence of pipelines may be executed without immediately waiting for it to 
terminate by following it with an &, which means to run it in background. 


Parentheses ( and ) around a pipeline or sequence of pipelines cause the whole 
series to be treated as a simple command, which may in turn be a component of 
a pipeline, etc. It is also possible to separate pipelines with’; |’ or ’&&’ 
indicating, as in the C language, that the second is to be executed only if the first 
fails or succeeds respectively. (See Expressions.) 


PROCESS I.D. NUMBERS 
When a process is run in background with &, the shell prints a line which looks 
like: 
1234 
indicating that the process which was started asynchronously was number 1234. 


STATUS REPORTING 
This shell learns immediately whenever a process changes state. It normally 
informs you whenever a job becomes blocked so that no further progress is 
possible, but only just before it prints a prompt. This is done so that it does not 
otherwise disturb your work. To check on the status of a process, use the ps 
(process status) command. 


SUBSTITUTIONS 
The shell performs various transformations on the input; these transformations 
are described in the order in which they occur. 


History Substitutions 
History substitutions place words from previous command input as portions of 
new commands, making it easy to repeat commands, repeat arguments of a 
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previous command in the current command, or fix spelling mistakes in the 
c™ previous command with little typing and a high degree of confidence. 


History substitutions begin with the character ! and may begin anywhere in the 
input stream with the provision that they do not nest. 


This ! may be preceded by a \ to turn off its special meaning; for convenience, a 
! is also passed unchanged when it is followed by a blank, tab, newline, = or (. 


Therefore, do not put a space after the ! and the command reference when 
invoking the history mechanism. History substitutions also occur when an input 
line begins with “. This special abbreviation is described later. 


An input line which invokes history substitution is echoed on the terminal before 
it is executed, as it would look if typed out in full. 


The shell history list, which may be seen by typing the history command, contains | 
all commands input from the terminal which consist of one or more words. | 
History substitutions reintroduce sequences of words from these saved commands 

an into the input stream. The history variable controls the size of the input stream. 
The previous command is always retained, regardless of its value. Commands are 
numbered sequentially from 1. 


Consider the following output from the history command: | 


9 write michael | 
10 ex write.c 

11 cat oldwrite.c 
12 diff *write.c 


The commands are shown with their event numbers. It is not usually necessary to 
use event numbers, but the current event number can be made part of the 
prompt by placing an ! in the prompt string. This is done by using the set 
command to set the Prompt = ! and the prompt character of your choice. 


For example, if the current event is number 13, the command recorded as event 
11 can be called in several ways: 


!-2 [i.e., 13-2] 


the first letter of one of its command words, such as !c referring to the c in 
cat 


'wri for event 9, or by a string contained in a word in the command as in 
!2mic? also referring to event 9. 
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These forms, without further modification, simply reintroduce the words of the 
specified events, each separated by a single blank. As a special case ’!!’ refers to 
the previous command; thus ’!!’ alone is essentially a redo. 


Words are selected from a command event and acted upon according to the 
following formula: 


event:position:action 


The event is the command you wish to retrieve. As mentioned above, it may be 
summoned up by event number and in several other ways. All that the event 
notation does is to tell the shell which command you want. 


Position picks out the words from the command event on which you want the 
action to take place. The position notation can do anything from altering the 
command completely to making some very minor substitution, depending on 

which words from the command event you specify with the position notation. 


To select words from a command event, follow the event specification with a : 
and a designator by position for the desired words. 


The words of a command event are picked out by their position in the input line. 
Positions are numbered from 0, the first word (usually command) being position 
0, the second word having position 1, and so forth. If you designate a word from 
the command event by stating its position, that means you want to include it in 
your revised command. All the words that you want to include in a revised 
command must be designated by position notation in order to be included. 


The basic position designators are: 


0 first (command) word 

n n’th argument 

“ first argument, 1.e. 1 

$ last argument 

% matches the word of an ?s? search which immediately 
precedes it; used to strip one word out of a command 
event for use in another command. 
Example: !?four?:%:p prints four. 

x-y range of words (e.g. 1-3 means from position 
1 to position 3). 

-y abbreviates 0-y 

' stands for -$, or indicates position 1 if only one 
word in event. | 

x*  abbreviates x-$ where x is a position number. 

x- like x * but omitting last word $ 
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The : separating the event specification from the word designator can be omitted 
“™ if the argument selector begins with a ~, $, *, -, or %. 


Modifiers, each preceded by a colon (:), may be used to act on the designated 
words in the specified command event. The following modifiers are defined: 


h Remove a trailing pathname component, leaving the head. 
r Remove a trailing .xxx component, leaving the root name. 
e Remove all but the extension .xxx part. 


sjold/new/ Substitute new for old 

t Remove all leading pathname components, leaving the tail. 

& Repeat the previous substitution. 

g Apply the change globally, prefixing the above, e.g. g&. 

p Print the new command but do not execute it. 

q Quote the substituted words, preventing further 
substitutions. 

x Like q, but break into words at blanks, tabs and newlines. 


Unless preceded by a g, the modification is applied only to the first modifiable 
word. With substitutions, it is an error for no word to be applicable. 


The left side of substitutions are not regular expressions in the sense of the 
editors, but rather strings. Any character may be used as the delimiter in place 
of /; a \ quotes the delimiter into the / and r strings. The character & in the right 
side is replaced by the text from the left. A \ quotes & also. A null / uses the 
previous string either from a/ or from a contextual scan string s in !?s5?. The 
trailing delimiter in the substitution may be omitted if (but only if) a newline 
follows immediately as may the trailing ? in a contextual scan. 


A history reference may be given without an event specification, e.g. !$. In this 
case the reference is to the previous command. If a previous history reference 
occurred on the same line, this form repeats the previous reference. Thus ’!?f00? 
!$’ gives the first and last arguments from the command matching ?foo?. 


“~ 


You can quickly make substitutions to the previous command line by using the 
character as the first non-blank character of an input line. This is equivalent to 
!:s* providing a convenient shorthand for substitutions on the text of the 
previous line. Thus “Ib lib fixes the spelling of lib in the previous command. 


A history substitution may be surrounded with { and } if necessary to insulate it 
from the characters which follow. Thus, after ’ls -ld ~ paul’ you might do !{l}a 
to do ’Is -Id ~ paula’, while !la would look for a command starting la. 


Quotations 
The quotation of strings by single and double quotation marks can be used to 
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prevent all or some of the remaining substitutions which would otherwise take 
place if these characters were interpreted as metacharacters or wild card 
matching characters. Strings enclosed in single quotation marks are prevented 
any further interpretation or expansion. Strings enclosed in double quotation 
marks may still be variable and command expanded as described below. 


In both cases the resulting text becomes all or part of a single word; only in one 
special case (see "Command Substitution" below) does a string enclosed in 
double quotation marks yield parts of more than one word; strings enclosed in 
single quotation marks never do. 


Alias Substitution 
The shell maintains a list of aliases which can be established, displayed and 
modified by the alias and unalias commands. After a command line is scanned, 
it is parsed into distinct commands and the first word of each command, left-to- 
right, is checked to see if it has an alias. If it does, then the text which is the 
alias for that command is reread with the history mechanism available as though 
that command were the previous input line. The resulting words replace the 
command and argument list. If no reference is made to the history list, then the 
argument list is left unchanged. 


Thus if the alias for ’Is’ is "Is -? the command ’Is /usr’ would map to "Is -1 /usr", 
the argument list here being undisturbed. Similarly if the alias for lookup’ was 
*grep !“/etc/passwd’ then "lookup bill" would map to "grep bill /etc/passwd". 


If an alias is found, the word transformation of the input text is performed and 
the alias process begins again on the reformed input line. Looping is prevented 
if the first word of the new text is the same as the old by flagging it to prevent 
further aliasing. Other loops are detected and cause an error. 


Note that the mechanism allows aliases to introduce parser metasyntax. Thus you 
can alias print "’pr \!* | lpr’" to make a command which pr’s its arguments to 
the line printer. 


Variable Substitution 
The shell maintains a set of variables, each of which has as value a list of zero or 
more words. Some of these variables are set by the shell or referred to by it. 
For instance, the argv variable is an image of the shell argument list, and words 
of this variable’s value are referred to in special ways. 


The values of variables may be displayed and changed by using the set and unset 
commands. Of the variables referred to by the shell a number are toggles; the 
shell does not care what their value is, only whether they are set or not. For 
instance, the verbose variable is a toggle which causes command input to be 
echoed. The setting of this variable results from the -v command line option. 
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Other operations treat variables numerically. The @ command permits numeric 

calculations to be performed and the result assigned to a variable. Variable 
values are, however, always represented as zero or more strings. For the 
purposes of numeric operations, the null string is considered to be zero, and the 
second and subsequent words of multiword values are ignored. 


After the input line is aliased and parsed, and before each command is executed, | 
variable substitution is performed keyed by $ characters. This expansion can be | 
prevented by preceding the $ with a \ except within strings enclosed in double 
quotation marks where it always occurs, and within strings enclosed in single 
quotation marks where it never occurs. Strings enclosed in single quotation 
marks are interpreted later (see Command Substitution below) so $ substitution 
does not occur there until later, if at all. A $ is passed unchanged if followed by 
a blank, tab, or end-of-line. 


Input/output redirections are recognized before variable expansion, and are 

variable expanded separately. Otherwise, the command name and entire 

argument list are expanded together. It is thus possible for the first (command) 

word to this point to generate more than one word, the first of which becomes 
rf» the command name, and the rest of which become arguments. 


Unless enclosed in double quotation marks or given the :q modifier the results of 

variable substitution may eventually be command and filename substituted. 

Within double quotation marks a variable whose value consists of multiple words 

expands to a portion of a single word, with the words of the variables value | 
separated by blanks. When the :q modifier is applied to a substitution the | 
variable expands to multiple words with each word separated by a blank and 

quoted to prevent later command or filename substitution. 


Metasequences for Variable Substitution 
The following metasequences are provided for introducing variable values into 
the shell input. Except as noted, it is an error to reference a variable which is 
not set. 


$name 
${name} | 
Are replaced by the words of the value of variable narne, each separated by 
rf» a blank. Braces insulate name from following characters which would 
| otherwise be part of it. Shell variables have names consisting of up to 20 
letters and digits starting with a letter. The underscore character is 
considered a letter. If name is not a shell variable, but is set in the 
environment, then that value is returned but : modifiers and the other forms 
given below are not available in this case. 
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$name{[selector] 
${ name[selector]} , 
May be used to select only some of the words from the value of name. The Naw 
selector is subjected to $ substitution and may consist of a single number or 
two numbers separated by a -. The first word of a variable’s value is 
numbered 1. If the first number of a range is omitted it defaults to 1. If 
the last member of a range is omitted it defaults to $#name. The selector * 
selects all words. It is not an error for a range to be empty if the second 
argument is omitted or in range. 
$#name 
${#name} 
Gives the number of words in the variable. This is useful for later use in a 
[selector]. 
$0 Substitutes the name of the file from which command input is being read. 
An error occurs if the name is not known. 
$number 
${ number} 
Equivalent to $argv[number]. 


$* Equivalent to $argv[*]. | 
The modifiers :h, :t, :r, :q, and :x may be applied to the substitutions above as 

may :gh, :gt, and :gr. If braces appear in the command form then the modifiers 

must appear within the braces. Only one : modifier is allowed on each $ 

expansion. 


The following substitutions may not be modified with : modifiers. 


$?name 

${?name} 
Substitutes the string 1 if name is set, 0 if it is not. 

$?0 Substitutes 1 if the current input filename is known, 0 if it is not. 

$$ Substitutes the (decimal) process number of the (parent) shell. 

$< Substitutes a line from the standard input, with no further interpretation 
thereafter. It can be used to read from the keyboard in a shell script. 


Command and Filename Substitution 
The remaining substitutions, command and filename substitution, are applied ; 
selectively to the arguments of built-in commands. This means that portions of oF 
expressions which are not evaluated are not subjected to these expansions. For 
commands which are not internal to the shell, the command name is substituted 
separately from the argument list. This occurs very late, after input-output 
redirection is performed, and in a child of the main shell. 
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Command Substitution 


Command substitution is indicated by a command enclosed in single quotation 
marks. The output from such a command is normally broken into separate words 
at blanks, tabs and newlines, with null words being discarded, this text then 
replacing the original string. Within double quotation marks, only newlines force 
new words; blanks and tabs are preserved. 


In any case, the single final newline does not force a new word. Note that it is 
thus possible for a command substitution to yield only part of a word, even if the 
command outputs a complete line. 


Filename Substitution 


If a word contains any of the characters *, ?, [, or { or begins with the character 
~ , then that word is a candidate for filename substitution, also known as 
globbing. This word is then regarded as a pattern, and replaced with an 
alphabetically sorted list of filenames which match the pattern. In a list of words 
specifying filename substitution it is an error for no pattern to match an existing 
filename, but it is not required for each pattern to match. Only the 
metacharacters *, ?, and [ imply pattern matching, the characters ~ 
more akin to abbreviations. 


and { being 


In matching filenames, the character period (.) at the beginning of a filename or 
immediately following a /, as well as the character / must be matched explicitly. 
The character * matches any string of characters, including the null string. The 
character ? matches any single character. The sequence [...] matches any one of 
the characters enclosed. Within [...], a pair of characters separated by - matches 
any character lexically between the two. 


a! 


The character ~ at the beginning of a filename is used to refer to home 
directories. Standing alone, it expands to the invokers home directory as 
reflected in the value of the variable home. When followed by a name consisting 
of letters, digits, and - characters the shell searches for a user with that name and 
substitutes their home directory; thus ~ ken might expand to /usr/ken and 

~ ken/chmach to /usr/ken/chmach. If the character ~ is followed by a character 
other than a letter or / or appears not at the beginning of a word, it is left 
undisturbed. 


The metanotation a{b,c,d}e is a shorthand for ’abe ace ade’. Left to right order 
is preserved, with results of matches being sorted separately at a low level to 
preserve this order. This construct may be nested. Thus ~ source/s1/{oldls,ls}.c 
expands to /usr/source/s1/oldls.c /usr/source/si/ls.c whether or not these files exist 
without any chance of error if the home directory for source is /usr/source. 
Similarly ./{memo,*box} might expand to ./memo ./box ../mbox. Note that 
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memo was not sorted with the results of matching *box. As a special case {, }, 
and { } are passed undisturbed. 


Input/Output 
The standard input and standard output of a command may be redirected with 
the following syntax: 


< name 
Open file name (which is first variable, command and filename expanded) 
as the standard input. 

< < word 
Read the shell input up to a line which is identical to word. Word is not 
subjected to variable, filename or command substitution, and each input 
line is compared to word before any substitutions are done on this input 
line. Unless a quoting \,", (accent), or * (grave) appears in word, 
variable and command substitution is performed on the intervening lines, 
allowing \ to quote $, \, and *. Commands which are substituted have all 
blanks, tabs, and newlines preserved, except for the final newline which is 
dropped. The resultant text is placed in an anonymous temporary file 
which is given to the command as standard input. 

> name 

>! name 

> & name 

> &! name 
The file name is used as standard output. If the file does not exist then it is 
created; if the file exists, it is truncated, its previous contents being lost. If 
the variable noc/lobber is set, then the file must not exist or be a character 
special file (e.g. a terminal or /dev/null) or an error results. This helps 
prevent accidental destruction of files. In this case the ! forms can be used 
and suppress this check. The forms involving & route the diagnostic output 
into the specified file as well as the standard output. Name is expanded in 
the same way as < input filenames are. 

> > name 

> >& name 

> >! name 

> >&! name 
Uses file narne as standard output like > but places output at the end of 
the file. If the variable noclobber is set, then it is an error for the file not to 
exist unless one of the ! forms is given. Otherwise similar to >. 


A command receives the environment in which the shell was invoked as modified 
by the input-output parameters and the presence of the command in a pipeline. 
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Thus, unlike some previous shells, commands run from a file of shell commands 
have no access to the text of the commands by default; rather they receive the 
original standard input of the shell. The ’< <’ mechanism should be used to 
present inline data. This permits shell command scripts to function as 
components of pipelines and allows the shell to block read its input. 


Diagnostic output may be directed through a pipe with the standard output. 
Sumply use the form | & rather than just |. 


Expressions 

A number of the built-in commands (to be described subsequently) take 
expressions, in which the operators are similar to those of C, with the same 
precedence. These expressions appear in the @, ext, if, and while commands. 
The following operators are available: 


Pt && | & == t= =" 17 <= s=< > << >> + -*} 


Here the precedence increases to the right, = =,!=, =~, and!~;.< =, >=, 
<,and >; < < and > >; + and -; *, /, and % being, in groups, at the same 
level. The = =,!=, =~, and!~ operators compare their arguments as strings; 
all others operate on numbers. The operators = ~ and !~ are like != and = = 
except that the right hand side is a pattern (containing, e.g. *s, ?s and instances 
of [...]) against which the left operand is matched. This reduces the need for use 
of the switch statement in shell scripts when all that is really needed is pattern 
matching. 


Strings which begin with 0 are considered octal numbers. Null or missing 
arguments are considered 0. The result of all expressions are strings, which 
represent decimal numbers. It is important to note that no two components of an 
expression can appear in the same word; except when adjacent to components of 
expressions which are syntactically significant to the parser- &, |, <, >, (, and ) 
- they should be surrounded by spaces. 


Also available in expressions as primitive operands are command executions 
enclosed in { and } and file enquiries of the form ’-/ name’ where / is one of: 


rs read access Ww write access 
x execute access e existence 
O ownership Z zero size 
f ordinary file d = directory 


The specified name is command and filename expanded and then tested to see if 
it has the specified relationship to the real user. If the file does not exist or is 
inaccessible, then all enquiries return false, i.e. 0. Command executions succeed, 


UP-13525 V1 Rt Page 11 


eee... 


CSH (1B) 


returning true, i.e. 1, if the command exits with status 0, otherwise they fail, 


returning false, i.e.0. If more detailed status information is required then the i> 
command should be executed outside of an expression and the variable status oF 
examined. 


CONTROL FLOW 
The shell contains a number of commands which can be used to regulate the flow 
of control in command files (shell scripts) and (in limited but useful ways) from 
terminal input. These commands all operate by forcing the shell to reread or 
skip in its input and, due to the implementation, restrict the placement of some 
of the commands. 


The foreach, switch, and while statements, as well as the if-then-else form of the if 
statement require that the major keywords appear in a single simple command on 
an input line as shown below. 


If the shell input is not seekable, the shell buffers up input whenever a loop is 

being read and performs seeks in this internal buffer to accomplish the rereading 

implied by the loop. To the extent that this allows, backward goto statements 

succeed on non-seekable inputs. iy 


BUILT-IN COMMANDS 
Built-in commands are executed within the shell. If a built-in command occurs as 
any component of a pipeline except the last then it is executed in a subshell. 


alias 

alias name 

alias name wordlist 
The first form prints all aliases. The second form prints the alias for name. 
The final form assigns the specified wordlist as the alias of name; wordlist is 
command and filename substituted. Name is not allowed to be alias or 
unalias. 

break 
Causes execution to resume after the end of the nearest enclosing foreach 
or while. The remaining commands on the current line are executed. 
Multi-level breaks are thus possible by writing them all on one line. 


breaksw p 
Causes a break from a switch, resuming after the endsw. Nad 
case label: 
A label in a switch statement as discussed below. 
cd 
cd name 


Page 12 UP-13525 V1 R1 


CSH(1B) 


chdir 


chdir name 
~~ Change the shell working directory to directory name. If no argument is 
| given then change to the home directory of the user. If name is not found 

as a subdirectory of the current directory and does not begin with /, ,/, or 
./, then each component of the variable cdpath is checked to see if it has a 
subdirectory name. If all else fails but name is a shell variable whose value 
begins with /, then this is tried to see if it is a directory. 

continue 
Continue execution of the nearest enclosing while or foreach. The rest of 
the commands on the current line are executed. 

default: 
Labels the default case in a switch statement. The default should come 
after all case labels. 

echo wordlist 

echo -n wordlist 
The specified words are written to the shell standard output, separated by 
spaces, and terminated with a newline unless the -n option is specified. 

~~ else 
end 
endif | 


endsw 

See the description of the foreach, if, switch, and while statements. 
exec command 

The specified command is executed in place of the current shell. 


exit 

exit(expr) 
The shell exits either with the value of the status variable (first form) or 
with the value of the specified expr (second form). 

foreach name (wordlist) 


end The variable name is successively set to each member of wordlist and the 
sequence of commands between this command and the matching end are 
executed. (Both foreach and end must appear alone on separate lines.) 
The built-in command continue may be used to continue the loop 
ta prematurely and the built-in command break to terminate it prematurely. 
| When this command is read from the terminal, the loop is read once 
prompting with ? before any statements in the loop are executed. If you 
make a mistake typing in a loop at the terminal you can rub it out. 
glob wordlist 
Like echo but no \ escapes are recognized and words are delimited by null 
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characters in the output. Useful for programs which wish to use the shell 
to filename expand a list of words. 

goto word | 
The specified word is filename and command expanded to yield a string of 
the form label. The shell rewinds its input as much as possible and 
searches for a line of the form label: possibly preceded by blanks or tabs. 
Execution continues after the specified line. 

history 
Displays the history event list. 

if (expr) command 
If the specified expression evaluates true, then the single command with 
arguments is executed. Variable substitution on command happens early, at 
the same time it does for the rest of the if command. Command must be a 
simple command, not a pipeline, a command list, or a parenthesized 
command list. Input/output redirection occurs even if expr is false, when 
command is not executed. 

if (expr) then 


else if (expr2) then 
else 


endif 
If the specified expr is true then the commands to the first else are 
executed; else if expr2 is true then the commands to the second else are 
executed, etc. Any number of else-if pairs are possible; only one endif is 
needed. The e/se part is likewise optional. The words else and endif must 
appear at the beginning of input lines; the if must appear at the beginning 
of its input line or after an else. 

kill pid 

kill -sig pid ... 

kill -l 
Sends either the TERM (terminate) signal or the specified signal to the 
specified processes. Signals are either given by number or by names (as 
given in /usr/include/signal.h, stripped of the prefix SIG). The signal names 
are listed by kill -l. There is no default, saying just kill does not send a 
signal to the current process. If the signal being sent is TERM (terminate) 
or HUP (hangup), then the job or process is sent a CONT (continue) signal 
as well. 

login 
Terminate a login shell, replacing it with an instance of /bin/login. This is 
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one way to log off, included for compatibility with sh (1). 


logout 
c~ Terminate a login shell. Especially useful if ignoreeof is set. 

nice 

nice + number 

nice command 

nice + number command 
The first form sets the nice for this shell to 4. The second form sets the 
nice to the given number. The final two forms run command at priority 4 
and number respectively. The superuser may specify negative niceness by 


using ’nice -number ...’. Command is always executed in a sub-shell, and 
the restrictions placed on commands in simple if statements apply. 
nohup 


nohup command 
The first form can be used in shell scripts to cause hangups to be ignored 
for the remainder of the script. The second form causes the specified 
command to be run with hangups ignored. All processes detached with & 
are effectively nohup’ed. 

aa onintr 

onintr - 

onintr label 
Control the action of the shell on interrupts. The first form restores the 
default action of the shell on interrupts which is to terminate shell scripts or 
to return to the terminal command input level. The second form ’onintr -’ 
causes all interrupts to be ignored. The final form causes the shell to 
execute a ’goto label’ when an interrupt is received or a child process 
terminates because it was interrupted. In any case, if the shell is running 
detached and interrupts are being ignored, all forms of onintr have no 
meaning and interrupts continue to be ignored by the shell and all invoked 
commands. 

rehash 
Causes the internal hash table of the contents of the directories in the path 
variable to be recomputed. This is needed if new commands are added to 
directories in the path while you are logged in. This should only be 
necessary if you add commands to one of your own directories, or if a 

il systems programmer changes the contents of one of the system directories. 

repeat count command 
The specified command, which is subject to the same restrictions as the 
command in the one line if statement above, is executed count times. I/O 
redirections occur exactly once, even if count is 0. 
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set 

set name 

set name = word 

set name[index] = word 

set name = (wordlist) 
The first form of the command shows the value of all shell variables. 
Variables which have other than a single word as value print as a 
parenthesized word list. The second form sets nae to the null string. The 
third form sets name to the single word. The fourth form sets the index’th 
component of name to word; this component must already exist. The final 
form sets name to the list of words in wordlist. In all cases the value 1s 
command and filename expanded. These arguments may be repeated to set 
multiple values in a single set command. Note, however, that variable 
expansion happens for all arguments before any setting occurs. 

setenv name value 
Sets the value of environment variable narne to be value, a single string. 
The variable PATH is automatically imported to and exported from the csh 
variable path; there is no need to use setenv for these. 

shift 

shift variable 
The members of argv are shifted to the left, discarding argv/1]. It is an error 
for argv not to be set or to have less than one word as value. The second 
form performs the same function on the specified variable. 

source name 
The shell reads commands from name. Source commands may be nested; if 
they are nested too deeply the shell may run out of file descriptors. An 
error in a source at any level terminates all nested source commands. Input 
during source commands is never placed on the history list. 

switch (string) 

case str1: 


breaksw 
default: 


breaksw 

endsw 
Each case label is successively matched against the specified string which is 
first command and filename expanded. The file metacharacters *, ?, and 
[...] may be used in the case labels, which are variable expanded. If none of 
the labels match before a default label is found, then the execution begins 
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after the default label. Each case label and the default label must appear at 
a the beginning of a line. The command breaksw causes execution to 
continue after the endsw. Otherwise control may fall through case labels 
and default labels as in C. If no label matches and there is no default, 
execution continues after the endsw. 
time | 
time command | 
With no argument, a summary of time used by this shell and its children is | 
printed. If arguments are given the specified simple command is timed and 
a time summary as described under the time variable is printed. If 
necessary, an extra shell is created to print the time statistic when the 
command completes. 
umask 
umask value 
The file creation mask is displayed (first form) or set to the specified value | 
(second form). The mask is given in octal. Common values for the mask | 
are 002 giving all access to the group and read and execute access to others | 
or 022 giving all access except no write access for users in the group or | 
others. 
unalias pattern 
All aliases whose names match the specified pattern are discarded. Thus 
all aliases are removed by ’unalias *’. It is not an error for nothing to be 
unaliased. 
unhash 
Use of the internal hash table to speed location of executed programs is 
disabled. 
unset pattern 
All variables whose names match the specified pattern are removed. Thus 
all variables are removed by ’unset *’; this has noticeably bad side-effects. 
It is not an error for nothing to be unset. 
wait All background jobs are waited for. If the shell is interactive, then an 
interrupt can disrupt the wait, at which time the shell prints names and job 
numbers of all jobs known to be outstanding. 
while (expr) 


ce” end While the specified expression evaluates non-zero, the commands between 
the while and the matching end are evaluated. Break and continue may be 
used to terminate or continue the loop prematurely. The while and end 
must appear alone on their input lines. Prompting occurs here the first 
time through the loop as for the foreach statement if the input is a terminal. 
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@ name = expr " 
@ namefindex] = expr \ } 


The first form prints the values of all the shell variables. The second form 
sets the specified name to the value of expr. If the expression contains <, 
>, &, or | then at least this part of the expression must be placed within ( 
and ). The third form assigns the value of expr to the index’th argument of 
name. Both name and its index’th component must already exist. The 
operators *=, + =, etc. are available as in C. The space separating the 
name from the assignment operator is optional. Spaces are, however, 
mandatory in separating components of expr which would otherwise be 
single words. Special postfix + + and -- operators increment and 
decrement name respectively, i.c.@ i++. 


PREDEFINED AND ENVIRONMENT VARIABLES 
The following variables have special meaning to the shell. Of these, argv, home, 
path, prompt, shell and status are always set by the shell. Except for status this 
setting occurs only at initialization; these variables are not then modified unless 
this is done explicitly by the user. 


This shell copies the environment variable USER into the variable user, TERM WU 
into term, and HOME into home, and copies these back into the environment 

whenever the normal shell variables are reset. The environment variable PATH 

is likewise handled; it is not necessary to worry about its setting other than in the 

file .cshrc as interior csh processes import the definition of path from the 

environment, and re-export it if you then change it. 


argv Set to the arguments to the shell, it is from this variable that positional 
parameters are substituted, i.e. $1 is replaced by Sargv{1], etc. 
cdpath 
Gives a list of alternate directories searched to find subdirectories in chdir 
commands. 
echo Set when the -x command line option is given. Causes each command and 
its arguments to be echoed just before it is executed. For non-built-in 
commands all expansions occur before echoing. Built-in commands are 
echoed before command and filename substitution, because these 
substitutions are then done selectively. ie 
history WwW 
Can be given a numeric value to control the size of the history list. Any 
command which has been referenced in this many events is not discarded. 
Too large values of history may run the shell out of memory. The last 
executed command is always saved on the history list. 
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home 
The home directory of the invoker, initialized from the environment. The 
filename expansion of ~ refers to this variable. 

ignoreeof 
If set the shell ignores end-of-file from input devices which are terminals. 
This prevents shells from accidentally being killed by control-d. 

mail The files where the shell checks for mail. This is done after each command 
completion which results in a prompt, if a specified interval has elapsed. 
The shell says "You have new mail.’ if the file exists with an access time not 
greater than its modify time. If the first word of the value of mail is 
numeric it specifies a different mail checking interval, in seconds, than the 
default, which is 10 minutes. If multiple mail files are specified, then the 
shell says ’New mail in name’ when there is mail in the file name. 

noclobber 
As described in the section on Input/Output, restrictions are placed on 
output redirection to insure that files are not accidentally destroyed, and 
that > > redirections refer to existing files. 

noglob 
If set, filename expansion is inhibited. This is most useful in shell scripts 
which are not dealing with filenames, or after a list of filenames has been 
obtained and further expansions are not desirable. 

nonomatch 
If set, it is not an error for a filename expansion to not match any existing 
files; rather the primitive pattern is returned. It is still an error for the 
primitive pattern to be malformed, i.e. "echo [" still gives an error. 

path Each word of the path variable specifies a directory in which commands are 
to be sought for execution. A null word specifies the current directory. If 
there is no path variable then only full pathnames execute. The usual 
search path is ., /bin, and /usr/bin, but this may vary from system to system. 
For the superuser the default search path is /etc, /bin, and /usr/bin. A shell 
which is given neither the -c nor the -t option normally hashes the contents 
of the directories in the path variable after reading .cshrc, and each time the 
path variable is reset. If new commands are added to these directories 
while the shell is active, it may be necessary to give the rehash or the 
commands may not be found. 

prompt 
The string which is printed before each command is read from an 
interactive terminal input. If a ! appears in the string it is replaced by the 
current event number unless a preceding \ is given. Default is % or # for 
the superuser. 
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shell The file in which the shell resides. This is used in forking shells to interpret 
files which have execute bits set, but which are not executable by the 
system. (See the description of Non-built-in Command Execution below.) 
Initialized to the pathname of the shell. 

status 
The status returned by the last command. If it terminated abnormally, then 
0200 is added to the status. Built-in commands which fail return exit status 
1, all other built-in commands set status 0. 

time Controls automatic timing of commands. If set, then any command which 
takes more than this many cpu seconds causes a line giving user, system, 
and real times and a utilization percentage which is the ratio of user plus 
system times to real time to be printed when it terminates. 

verbose 
Set by the -v command line option, causes the words of each command to 
be printed after history substitution. 


NON-BUILT-IN COMMAND EXECUTION 
When a command to be executed is found not to be a built-in command the shell 
attempts to execute the command via exec(2). Each word in the variable path 
names a directory from which the shell attempts to execute the command. If it 
is given neither a -c nor a -t option, the shell hashes the names in these 
directories into an internal table so that it only tries an exec in a directory if there 
is a possibility that the command resides there. This greatly speeds command 
location when a large number of directories are present in the search path. If 
this mechanism has been turned off (via unhash), or if the shell was given a -c or 
-t option, and in any case for each directory component of path which does not 
begin with a /, the shell concatenates with the given command name to form a 
pathname of a file which it then attempts to execute. 


Parenthesized commands are always executed in a subshell. Thus "(cd ; pwd) ; 
pwd" prints the home directory; leaving you where you were (printing this after 
the home directory), while "cd ; pwd" leaves you in the home directory. 
Parenthesized commands are most often used to prevent chdir from affecting the 
current shell. 


If the file has execute permissions but is not an executable binary to the system, 
then it is assumed to be a file containing shell commands and a new shell 1s 
spawned to read it. 


If there is an alias for shell then the words of the alias are prepended to the 
argument list to form the shell command. The first word of the alias should be 
the full pathname of the shell (e.g. $shell). Note that this is a special, late 
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occurring, case of alias substitution, and only allows words to be prepended to 
the argument list without modification. 


ARGUMENT LIST PROCESSING 
If argument 0 to the shell is - then this is a login shell. The flag arguments are 
interpreted as follows: 


-¢© Commands are read from the (single) following argument which must be 
present. Any remaining arguments are placed in argv. 

-e The shell exits if any invoked command terminates abnormally or yields a 
non-zero exit status. 

-f | The shell starts faster because it neither searches for nor executes 
commands from the file .cshrc in the invoker’s home directory. 

-i_ The shell is interactive and prompts for its top-level input, even if it appears 
to not be a terminal. Shells are interactive without this option if their 
inputs and outputs are terminals. 

-n Commands are parsed, but not executed. This may aid in syntactic 
checking of shell scripts. 

-s | Command input is taken from the standard input. 

-t A single line of input is read and executed. A \ may be used to escape the 
newline at the end of this line and continue onto another line. 

-v Causes the verbose variable to be set, with the effect that command input is 
echoed after history substitution. 

-x Causes the echo variable to be set, so that commands are echoed 
immediately before execution. 

-V Causes the verbose variable to be set even before .cshrc is executed. 

-X Is to-xas-Vis to -v. 


After processing of flag arguments, if arguments remain but none of the -c, -i, -s, 
or -t options was given, the first argument is taken as the name of a file of 
commands to be executed. The shell opens this file, and saves its name for 
possible resubstitution by $0. Remaining arguments initialize the variable argv. 


SIGNAL HANDLING 
The shell normally ignores quit signals. Processes running in background (by &) 
are immune to signals generated from the keyboard, including hangups. Other 
signals have the values which the shell inherited from its parent. The shell’s 
handling of interrupts and terminate signals in shell scripts can be controlled by 
onintr. Login shells catch the terminate signal; otherwise this signal is passed on to 
children from the state in the shell parent. In no case are interrupts allowed 
when a login shell is reading the file .logout. 
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FILES 
~/.cshrc —- Read at beginning of execution by each shell. 
~ / login Read by login shell, after .cshrc at login. 
~/jlogout Read by login shell, at logout. 
/bin/sh Standard shell, for shell scripts not starting with a #. 
/tmp/sh* Temporary file for ’< <’. 
/etc/passwd Source of home directories for ~ name. 


LIMITATIONS 
Words can be no longer than 1024 characters. The system limits argument lists 
to 5120 characters. The number of arguments to a command which involves 
filename expansion is limited to 1/6th the number of characters allowed in an 
argument list. Command substitutions may substitute no more characters than 
are allowed in an argument list. To detect looping, the shell restricts the number 
of alias substitutions on a single line to 20. 


SEE ALSO 
sh(1) 
access(2), exec(2), fork(2), pipe(2), signal(2), umask(2), wait(2), a.out(4) in the 
Programmer’s Reference Manual 


RESTRICTIONS 
It suffices to place the sequence of commands in parentheses to force it to a 
subshell, 1.e.(a;b;c). 


Control over tty output after processes are started is primitive. 


Alias substitution is most often used to clumsily simulate shell procedures; shell 
procedures should be provided rather than aliases. 


Commands within loops, prompted for by ?, are not placed in the history list. 
Control structure should be parsed rather than being recognized as built-in 
commands. This would allow control commands to be placed anywhere, to be 
combined with |, and to be used with & and ; metasyntax. 


It should be possible to use the : modifiers on the output of command 
substitutions. All and more than one : modifier should be allowed on $ 
substitutions. 
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NAME 
in csplit - context split 


SYNOPSIS 
csplit [-s] [-k] [-f prefix] file argi [... argn] 


DESCRIPTION 
The csplit command reads file and separates it into n+1 sections, defined by the 
arguments arg]... argn. By default the sections are placed in xx00 ... xx (n 
may not be greater than 99). These sections get the following pieces of file: 


00: From the start of file up to (but not including) the line referenced 
by argl. 
01: From the line referenced by arg] up to the line referenced by arg2. 


n+1: From the line referenced by argn to the end of file. 
If the file argument is a - then standard input is used. 


rn The options to csplit are: 


-S csplit normally prints the character counts for each file created. 
If the -s option is present, csplit suppresses the printing of all 
character counts. 


-k csplit normally removes created files if an error occurs. If the -k 
option is present, csplit leaves previously created files intact. 


-f prefix If the -f option is used, the created files are named prefix00 ... 
prefin. The default 1s xx00... xx. 


The arguments (arg] ... argn) to csplit can be a combination of the following: 


/rexp/___ A file is to be created for the section from the current line up to 
(but not including) the line containing the regular expression 
rexp. The current line becomes the line containing rexp. This 
argument may be followed by an optional + or - some number 
of lines (e.g., /Page/-5). 


r~ Yorexp% This argument is the same as /rexp/, except that no file is created 
| for the section. 


Inno A file is to be created from the current line up to (but not 
including) Inno. The current line becomes /nno. 
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{num} Repeat argument. This argument may follow any of the above 
arguments. If it follows a rexp type argument, that argument is 
applied num more times. If it follows /nno, the file is split every 
Inno lines (num times) from that point. 


Enclose all rexp type arguments that contain blanks or other characters 
meaningful to the shell in the appropriate quotes. Regular expressions may not 
contain embedded newlines. csplit does not affect the original file; it is the user’s 
responsibility to remove it. 


Internationalization 
csplit can process characters from supplementary code sets. In regular 
expressions, searches are performed on characters, not bytes. 


Option: 
-f prefix Characters from supplementary code sets can be used for prefix. 


EXAMPLES 
csplit -f cobol file ’/procedure division’ /parS./ /par16./ 


This example creates four files, cobol00 ... cobol03. After editing the "split" files, 
they can be recombined as follows: 


cat cobol0[0-3] > file 
Note that this example overwrites the original file. 
csplit -k file 100 {99} 


This example would split the file at every 100 lines, up to 10,000 lines. The -k 
option causes the created files to be retained if there are less than 10,000 lines; 
however, an error message would still be printed. 


csplit -k prog.c ’%main(%’ ’*/~}/+1 {20} 


Assuming that prog.c follows the normal C coding convention of ending routines 
with a } at the beginning of the line, this example creates a file containing each 
separate C routine (up to 21) in prog.c. 


SEE ALSO 


ed(1), sh(1) 
regexp(5) in the Programmer’s Reference Manual 
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DIAGNOSTICS 
c~ Self-explanatory except for: 
: > arg - out of range 
which means that the given argument did not reference a line between the 
current position and the end of the file. 
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NAME 
ct - spawn getty to a remote terminal 


SYNOPSIS 
ct [ -wn ] [ -xn ] [ -h ] [ -v ] [ -sspeed ] telno ... 


DESCRIPTION 
The ct command dials the telephone number of a modem that is attached to a 
terminal, and spawns a getty process to that terminal. Teno is a telephone 
number, with equal signs for secondary dial tones and minus signs for delays at 
appropriate places. (The set of legal characters for telno is 0 thru 9, -, =, *, and 
#. The maximum length felno is 31 characters). If more than one telephone 
number is specified, ct tries each in succession until one answers; this is useful 
for specifying alternate dialing paths. 


ct tries each line listed in the file /usr/lib/uucp/Devices until it finds an available 
line with appropriate attributes or runs out of entries. If there are no free lines, 
ct asks if it should wait for one, and if so, for how many minutes it should wait 
before it gives up. cf continues to try to open the dialers at one-minute intervals 
until the specified limit is exceeded. The dialogue may be overridden by 
specifying the -wn option, where n is the maximum number of minutes that ct is 
to wait for a line. 


The -xn option is used for debugging; it produces a detailed output of the 
program execution on stderr. The debugging level, , is a single digit; -x9 is the 
most useful value. 


Normally, ct hangs up the current line so the line can answer the incoming call. 
The -h option prevents this action. The -h option also waits for the termination 
of the specified ct process before returning control to the user’s terminal. If the 
-vV option is used, cf sends a running narrative to the standard error output 
stream. 


The data rate may be set with the -s option, where speed is expressed in baud. 
The default rate is 1200. 


After the user on the destination terminal logs out, there are two things that 
could occur depending on what type of getty is on the line (getty or uugetty). For 
the first case, ct prompts, Reconnect? If the response begins with the letter n, 
the line is dropped; otherwise, getty is started again and the login: prompt is 
printed. In the second case, there is already a getty (uugetty) on the line, so the 
login: message appears. 
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To log out properly, the user must type control D. 


Of course, the destination terminal must be attached to a modem that can answer ~ | 
the telephone. a 


FILES 
/usr/lib/uucp/Devices 
/usr/adm/ctlog 


SEE ALSO 
cu(1C), login(1), uucp(1C) 
getty(1M), uugetty(1M) in the System Administrator’s Reference Manual 


BUGS 
For a shared port, one used for both dial-in and dial-out, the uugetty program 
running on the line must have the -r option specified [see uugetty(1M)]. 
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NAME 
cu - call another UNIX system 


Cy SYNOPSIS 


cu [-s speed] [-l line] [-h] [-t] [-d] [-e}-o] [-n] telno 
cu [-s speed] [-h] [-d] [-e}-o] -1 line 
cu [-h] [-d] [-e!-o] systemname 


DESCRIPTION , 
The cu command calls up another UNIX system, a terminal, or possibly a non- 
UNIX system. It manages an interactive conversation with possible transfers of 
ASCII files. 


OPTIONS 
The cu command accepts the following options and arguments. 


-s speed 
Specifies the transmission speed (300, 1,200, 2,400, 4,800, 9,600, 19,200); the 
default value is "Any" speed and depends on the order of the lines in the 
/usr/lib/uucp/Devices file. Most modems are either 300 or 1200 baud. 
r~ Directly connected lines may be set to a speed higher than 1200 baud. 


-I line 
Specifies a device name to use as the communication line. This can be used 
to override a search for the first available line with the right speed. When 
the -1 option is used without the -s option, the speed of a line is taken from 
the file /usr/lib/uucp/Devices. When the -l and -s options are used 
simultaneously, cu searches the Devices file to check if the requested speed 
for the requested line is available. If so, the connection is made at the 
requested speed; otherwise an error message is printed and the call is not 
made. The specified device is generally a directly connected asynchronous 
line which does not require a phone number. If the specified device is 
associated with a modem with automatic dial capabilities, a phone number 
must be provided. Using this option with systemname rather than telno does 
not give the proper results (see systemname). 


-h Emulates local echo, supporting calls to other computer systems which 
o™ expect terminals to be set to half-duplex mode. 
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-t | Used when dialing an ASCII terminal which has been set to auto answer. 
Appropriate mapping of carriage-return to carriage-return-line-feed pairs is 
set. 


-d Causes diagnostic traces to be printed. 


-e Designates that even parity is to be generated for data sent to the remote. 
Even parity is typically used on your UNIX-based system. 


-o Designates that odd parity is to be generated for data sent to the remote. 


NOTE: The cu command typically runs without parity unless the -e or -o options 
are used. If neither option is used when calling a remote system using parity, 
parity errors occur on the remote system. To the cu user, the parity errors are 
transparent except for a likely decrease in speed. If the remote system has an 
activated tally manager, the errors are logged. To avoid parity errors, match the 
parity of the remote system with either the -e or -o options. 


-n_. Requests the phone number to be dialed from the user rather than taking it 
from the command line. 


telno When using a modem with automatic dial capabilities, the argument is the 
telephone number with equal signs for the secondary dial tone or minus 
signs placed appropriately for delays of 4 seconds. 


systemname 
A uucp(1C) system name may be used rather than a phone number; in this 
case, cu obtains an appropriate direct line or phone number (if using a 
modem with automatic dial capabilities) from /usr/lib/uucp/Systems. 
Systemname must begin with an upper or lowercase alphabetic character 
and should not contain a slash (/) character. 


NOTE: The systemname option should not be used in conjunction with the -l and 
-s options as cu connects to the first available line for the system name specified, 
ignoring the requested line and speed. 


PROCESS DESCRIPTION 
After making the connection, cu runs as two processes: (1) the transmit process 
reads data from the standard input and, except for lines beginning with ~, passes 
it to the remote system; and (2) the receive process accepts data from the remote 
system and, except for lines beginning with ~, passes it to the standard output. 
Typically, an automatic DC3/DC1 protocol is used to control input from the 
remote so the buffer is not overrun. Lines beginning with ~ have special 
meanings. 
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The transmit process interprets the following: 


—, 


i Send a sequence of < Ctrl > D characters to terminate the current 
| process on the remote system in an orderly fashion and then terminate the 
conversation. 


Terminate the conversation immediately. ~.. does not terminate 
conversations in an orderly fashion. Processes currently running on the 
remote system may continue to run after the conversation is terminated. 


ae. 


Escape to an interactive shell on the local system. 


™~ lomd... 
Run cmd on the local system (via sh -c). 


~ $emd... 
Run cmd locally and send its output to the remote system. 


OMG » «5 
Run the protocol command cmd locally, disabling the receive process of cu. 
See rz(1) and sz(1). 


f : ~ Jord 


Change the directory on the local system. 


NOTE: ~ !cd causes the command to be run by a sub-shell, which is probably not 
what was intended. 


~ %take from [ to | 
Copy file from (on the remote system) to file fo on the local system. If to 1s 
omitted, the from argument is used in both places. As each block of the 
file is transferred, consecutive single digits are printed to the terminal. See 
WARNINGS. 


~Q%put from [ to | 
Copy file from (on local system) to file to on remote system. If fo cannot 
be created, the file is transferred to /dev/null. If to is omitted, the from 
argument is used in both places. As each block of the file is transferred, 
consecutive single digits are printed to the terminal. See WARNINGS. 


o™ ~ Ytakez file... 

| Copy files from the remote system to the local system using ZMODEM 
protocol. Full pathnames may be specified. Shell metacharacters are 
expanded on the remote system. See WARNINGS. 


~ Yoputz file... 
Copy files from the local system to the remote system using ZMODEM 
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protocol. Full pathnames may be specified. Shell metacharacters are 
expanded on the local system. See WARNINGS. 


~ %takex from [ to | 
Copy file from (on the remote system) to file to on the local system using 
XMODEM protocol. If to is omitted, the from argument is used in both 
places. See WARNINGS. 


~ Yputx from [ to | 
Copy file from (on local system) to file to on remote system using 
_ XMODEM protocol. If to is omitted, the from argument is used in both 
places. See WARNINGS. 


~ %dunld file 
Download a file on the remote system to file on the local system using 
XMODEM protocol. The user must start the transfer on the remote 
system before issuing this command. 


~ Youpld file 
Upload a file file on the local system to the remote system using 
XMODEM protocol. The user must start the transfer on the remote 
system before issuing this command. 

~ | lines 

Send the line ~... to the remote system. 

~ Ybreak . 
Transmit a BREAK to the remote system (which can also be specified as 
~ %b). 

~ %odebug 
Toggle the debugging option on or off (which can also be specified as 
~ Jd). 


~ft Print the values of the termio structure variables for the user’s terminal. 
This is useful for debugging. 


~] Print the values for the termio structure variables for the remote 
communication line. This is useful for debugging. 


~ Ynostop 


Toggle between DC3/DC1 input control protocol and no input control. 
This is useful if the remote system is one which does not respond properly 
to the DC3 and DC1 characters. 
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~ %noxon 
Same as ~ %nostop. 


~ Ynoxoft 
Toggle between DC3/DC1 output control protocol and no output control. 
This is useful if the remote system is one which sends the DC3 and DC1 
characters at odd times (i.e., cursor motion sequences). 


The receive process normally copies data from the remote system to its standard 
output. A line from the remote that begins with ~ initiates an output diversion to 
a file. 


Data from the remote system is diverted (or appended, if > > is used) to file on 
the local system. The trailing ~ > terminates the diversion. 


The use of ~ %put requires stty(1) and cat(1) on the remote side. It also 
requires that the current erase and kill characters on the remote system be 
identical to the current ones on the local system. Backslashes are inserted at 
appropriate places. 


The use of ~ %take requires the existence of echo(1) and cat(1) on the remote 
system. Also, stty tabs mode should be set on the remote system if tabs are to be 
copied without expansion to spaces. 


The use of ~ %putz and ~ %putx requires rz(1) on the remote system. Files are 
always copied exactly byte-for-byte and overwrite existing files of the same name. 


The use of ~ %takez and ~ %takex requires sz(1) on the remote system. Files 
are always copied exactly byte-for-byte and overwrite existing files of the same 
name. 


When cu is used on system X to connect to system Y, and subsequently used on 
system Y to connect to system Z, commands on system Y can be executed by 
using ~ ~. Performing a tilde command reminds the user of the local system 
uname. For example, uname(1) can be executed on Z, X, and Y as follows: 


uname 

Z 

~ [X]!uname 

x 

~ ™~fY]!uname 


In general, ~ causes the command to be executed on the original machine, 
~ ™ causes the command to be executed on the next machine in the chain. 
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EXAMPLES 
To dial a system whose phone number is 9 201 555 1212 using 1200 baud (where 
a dial tone is expected after the 9): 


cu -s 1200 9=12015551212 
To login to a system connected by a direct line: 
cu -l /dev/ttyXXX or 


cu -l ttyXXX 
To dial a system with a specific line and a specific speed: 


cu -s 1200 -l /dev/ttyXXxX 


NOTE: If connected by cu to a remote system that is reset, crashes, or 1s 
shutdown, the user may disconnect from the remote system by performing a ~. 
(tilde, dot). After the ~. is performed, an approximate delay of 10 seconds 
occurs before the cu is terminated. To terminate the cu more quickly, a ~.. "4 
(tilde, dot, dot) may be performed. we, 


FILES 
/usr/lib/uucp/Systems 
/usr/lib/uucp/Devices 
/usr/spool/locks/LCK..(tty-device) 


NOTES 
If cu is being used for a connection to a remote system which has crashed or is 
shut down and the connection appears locked up, performing a ~ . (tilde, dot) 
should disconnect the user in approximately 10 seconds, or a ~ .. (tilde, dot, dot) 
should disconnect the user even sooner. 


Because many applications, such as vi(1), use control characters, the default 

setting for cu does not follow DC1/DC3 protocol (i.e. -ixoff is not set on the 

local port). However, if it appears that data is being lost during a cu session, the 

user may want to toggle the nostop option which sets ixoff on the local port. _— 


SEE ALSO Ww 


cat(1), ct(1C), echo(1), rz(1), stty(1), sz(1), uname(1), uucp(1C) 


DIAGNOSTICS 
Exit code is zero for normal exit, non-zero (various values) otherwise. 
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WARNINGS 
The cu command does not do any integrity checking on data it transfers without 
XMODEM and ZMODEM. Data fields with special cu characters may not be 
transmitted properly. Depending on the interconnection hardware, it may be 
necessary to use a ~ . to terminate the conversion even if stty 0 has been used. 
Non-printing characters are not dependably transmitted using either the ~ %put 
or ~ %take commands. There is an artificial slowing of transmission by cu 
during the ~ %put operation so that loss of data is unlikely. 


Both ~ %putz and ~ %takez entertain the user with cryptic, diagnostic patter 
during long file transfers. Both ~ %putx and ~ %takex add up to 127 bytes of 
spurious data per file due to XMODEM constraints. XMODEM and 
ZMODEM require an 8-bit data path. 


RESTRICTIONS 
cu buffers input internally. 


cu does not support auto-dialing. 


cu cannot call systems whose names begin with numeric values because the 
systemname is interpreted as a telephone number. The first character of the 
systemname must be alphabetic. It is recommended that the rest of the name be 
alphanumeric if uucp communication is established. 
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NAME 
cut - cut out selected fields of each line of a file 


SYNOPSIS 


cut -clist [file ...] 
cut -flist [-dchar] [-s] [file ...] 


DESCRIPTION 
Use cut to cut out columns from a table or fields from each line of a file; in data 
base parlance, it implements the projection of a relation. The fields as specified 
by dist can be fixed length, i.e., character positions as on a punched card (-c 
option) or the length can vary from line to line and be marked with a field 
delimiter character like tab (-f option). cut can be used as a filter; if no files are 
given, the standard input is used. In addition, a filename of - explicitly refers to 
standard input. 


The meanings of the options are: 


list A comma-separated list of integer field numbers (in increasing order), 
with optional - to indicate ranges [e.g., 1,4,7; 1-3,8; -5,10 (short for 
1-5,10); or 3- (short for third through last field)]. 


-clist The list following -c (no space) specifies character positions (e.g., -c1-72 
would pass the first 72 characters of each line). 


-flist | The list following -f is a list of fields assumed to be separated in the file 
by a delimiter character (see -d ); e.g., -f1,7 copies the first and seventh 
field only. Lines with no field delimiters are passed through intact 
(useful for table subheadings), unless -s is specified. 


-dchar The character following -d is the field delimiter (-f option only). Default 
is tab. Space or other characters with special meaning to the shell must 
be quoted. 


-§ Suppresses lines with no delimiter characters in case of -f option. 
Unless specified, lines with no delimiters are passed through untouched. 


Either the -c or -f option must be specified. 


Use grep(1) to make horizontal "cuts" (by context) through a file, or paste(1) to 
put files together column-wise (i.e., horizontally). To reorder columns in a table, 
use cut and paste. 
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Internationalization | 
cut can process characters from supplementary code sets. 


Options 
-elist Positions list must be specified as column position rather than 
characters. When multibyte characters are split at a specified 


position, the remaining column positions are filled with an 
appropriate number of ASCII spaces instead of characters. 


-d char The field delimiter character can be a character from a 
| supplementary code set. 


EXAMPLES 
cut -d: -f1,5 /etc/passwd mapping of user IDs to names 


name= ‘who ami | cut -fl-d""* to set name to current login name. 


DIAGNOSTICS 
ERROR: line too long 


A line can have no more than 1023 characters or fields, or 


there is no newline character. 


ERROR: bad list for c/f option 


Missing -c or -f option or incorrectly specified fist. No error 


occurs if a line has fewer fields than the /Jist calls for. 
ERROR: no fields ‘The list 1s empty. 


ERROR: no delimeter 
Missing char on -d option. 


ERROR: cannot handle multiple adjacent backspaces 
Adjacent backspaces cannot be processed correctly. 


WARNING: cannot open <filename > 
Either filename cannot be read or does not exist. If 
multiple filenames are present, processing continues. 


SEE ALSO) 
grep(1), paste(1) 
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NAME 
cw, checkcw — prepare constant-width text for troff 


~* SYNOPSIS 


cw [ -Ixx ] [ —rxx ] [ -fn ] [ +t] [ +t ] [ -d ] [ files ] 
checkcw [ -—1xx ] [ -rxx ] files 


DESCRIPTION 
The cw command is a preprocessor for troff [see nroff(1)] input files that contain text 
to be typeset in the constant-width (CW) font on the Wang CAT phototypesetter. 


Text typeset with the CW font resembles the output of terminals and of line printers. 
This font is used to typeset examples of programs and of computer output in user 
manuals, programming texts, etc. It has been designed to be quite distinctive (but 
not overly obtrusive) when used together with the Times Roman font. 


Because the CW font on the Wang CAT contains a non-standard set of characters and 
because text typeset with it requires different character and inter-word spacing than is 
used for standard fonts, documents that use the CW font must be preprocessed by cw. 


The CW font contains the 94 printing ASCII characters: 


abcdefghijkIlmnopqrstuvwxyz 
ABCDEFGHIJKLMNOPQRSTUVWXYZ 
0123456789 
1$%&()6'*4+@.,/:;=7[]1-_A~"<>{} #\ 


plus eight non-ASCII characters represented by four-character troff names (in some 
Cases attaching these names to non-standard graphics): 


Character Symbol _ troff Name 
"Cents" sign ¢ \(ct 
1EBCDIC "not" sign aa \(no 
Left arrow - \(<- 
Right arrow > \(-> 
Down arrow L \(da 
Vertical single quote , \(fm 
fe Control-shift indicator 4 \(dg 
| Visible space indicator 4 \(sq 
Hyphen - \(hy 
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The hyphen is a synonym for the unadorned minus sign (-). Certain versions of cw 
recognize two additional names: \(ua for an up arrow and \(ih for a diagonal left-up 
(home) arrow. 


The cw command recognizes five request lines, as well as user-defined delimiters. 
The request lines look like troff macro requests, and are copied in their entirety by 
cw onto its output; thus, they can be defined by the user as troff macros; in fact, the 
-CW and .CN macros should be so defined (see HINTS). The five requests are: 


CW _ Start of text to be set in the CW font; .CW causes a break; it can take pre- 
cisely the same options, in precisely the same format, as are available on the 
cw command line. 


.CN End of text to be set in the CW font; .CN causes a break; it can take the 
same options as are available on the cw command line. 


«CD Change delimiters and/or settings of other options; takes the same options as 
| are available on the cw command line. 


-CP argl arg2 arg3 ... argn 
All the arguments (which are delimited like troff macro arguments) are con- 
catenated, with the odd-numbered arguments set in the CW font and the 
even-numbered ones in the prevailing font. 


~PC arg! arg2 arg3 ... argn 
Same as .CP, except that the even-numbered arguments are set in the CW 
font and the odd-numbered ones in the prevailing font. 


The .CW and .CN requests are meant to bracket text (e.g., a program fragment) that 
is to be typeset in the CW font as is. Normally, cw operates in the transparent mode. 
In that mode, except for the .CD request and the nine special four-character names 
listed in the table above, every character between .CW and .CN request lines stands 
for itself. In particular, cw arranges for periods (.) and apostrophes (’) at the begin- 
ning of lines, and backslashes (\) everywhere to be hidden from troff. The tran- 
sparent mode can be tumed off (see following), in which case normal troff rules 
apply; in particular, lines that begin with . and ’ are passed through untouched 
(except if they contain delimiters; see following). In either case, cw hides the effect 
of the font changes generated by the .CW and .CN requests; cw also defeats all liga- 
tures (fi, ff, etc.) in the CW font. 


The only purpose of the .CD request is to allow the changing of various options other 
than just at the beginning of a document. 


The user can also define delimiters. The left and right delimiters perform the same 
function as the .CW/.CN requests; they are meant, however, to enclose CW "words" 
or "phrases" in running text (see examples under RESTRICTIONS). cw treats text 
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between delimiters in the same manner as text enclosed by .CW/.CN pairs, except 
that, for aesthetic reasons, spaces and backspaces inside .CW/.CN pairs have the 
same width as other CW characters. While spaces and backspaces between delimiters 
are half as wide, so they have the same width as spaces in the prevailing text (but are 
not adjustable). Font changes due to delimiters are not hidden. 


Delimiters have no special meaning inside .CW /.CN pairs. 
The options are: 


~-lxx The one- or two-character string xx becomes the left delimiter; if xx is omitted, 
the left delimiter becomes undefined, which it 1s initially. 


-rxx Same for the right delimiter. The left and right delimiters may (but need not) 
be different. 


-fn The CW font is mounted in font position n; acceptable values for n are 1, 2, 
and 3 (default is 3, replacing the bold font). This option is only useful at the 
beginning of a document. 


-t Turn transparent mode off. 
+t Tur transparent mode on (this is the initial default). 


-—d Print current option settings on standard error in the form of troff comment 
lines. This option is meant for debugging. 


cw reads the standard input when no files are specified (or when "-" is specified as 
the last argument), so it can be used as a filter. Typical usage 1s: 


cw files | troff ... 


checkcw checks that left and right delimiters, as well as the .CW/.CN pairs, are prop- 
erly balanced. It prints out all offending lines. 


HINTS 


Typical definitions of the .CW and .CN macros meant to be used with the mm(S5) 
macro package: 


.de CW 

DS I 

.ps 9 

.vs 10.5p 

ta 16m/3u 32m/3u 48m/3u 64m/3u 80m/3u 96m/3u ... 
.de CN 

.ta 0.51 11 1.51 21 2.51 31 3.51 41 4.51 51 5.51 61 

.VS 
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.ps 
.DE 


At the very least, the .CW macro should invoke the troff no-fill (.nf) mode. 


When set in running text, the CW font is meant to be set in the same point size as the 
rest of the text. In displayed matter, on the other hand, it can often be profitably set 
One point smaller than the prevailing point size. The CW font is sized so that, when 
it is set in 9-point, there are 12 characters per inch. 


Documents that contain CW text may also contain tables and/or equations. If this is 
the case, the order of preprocessing should be: cw, tbl, and eqn. Usually, the tables 
contained in such documents do not contain any CW text, although it is entirely pos- 
sible to have elements of the table set in the CW font; of course, care must be taken 
that tb/(1) format information not be modified by cw. Attempts to set equations in 
the CW font are not likely to be either pleasing or successful. 


In the CW font, overstriking is most easily accomplished with backspaces: letting <— 
represent a backspace, d«-<-\(dg yields ¢. Because backspaces are half as wide 
between delimiters as inside .CW/.CN pairs (see above), two backspaces are required 
for each overstrike between delimiters. 


FILES 
/usr/lib/font/ftCW CW font-width table 


SEE ALSO 
eqn(1), nroff(1), tbl(1) 
mm(5), mv(5) in the Programmer’s Reference Manual 

WARNINGS ; 
If text preprocessed by cw is to make any sense, it must be set on a typesetter 
equipped with the CW font or on a STARE facility. On the latter, the CW font 
appears as bold, but with the proper CW spacing. 


RESTRICTIONS 
The use of periods (.), backslashes (\), or double quotes (") as delimiters or as argu- 
ments to .CP and .PC is greatly discouraged. 


Certain CW characters do not concatenate gracefully with certain Times Roman char- 
acters, e.g., a CW ampersand (&) followed by a Times Roman comma(,). In such 
cases, judicious use of troff half- and quarter-spaces (\| and \4) is satisfactory, e.g., 
one should use _&_\4, (rather than just plain _&_,) to obtain &, (assuming that _ is 
used for both delimiters). 


Using cw with nroff is non-productive. 
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The output of cw is hard to read. 


a See RESTRICTIONS under nroff(1). 
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NAME 
date - print and set the date 


SYNOPSIS 
date [ mmddhhmm|[yy] ] | +format | 


DESCRIPTION 
If no argument is given, or if the argument begins with +, the current date and 
time are printed. Otherwise, the current date is set. The first mm is the month 
number; dd is the day number in the month; hh is the hour number (24 hour 
system); the second mm is the minute number; yy is the last 2 digits of the year 
number and is optional. For example: 


date 10080045 


sets the date to Oct 8, 12:45 AM. The current year is the default if no year is 
mentioned. The system operates in GMT. date takes care of the conversion to 
and from local standard and daylight time. Only the superuser may change the 
date. When the date and time are set successfully, date displays the new date 
according to the format defined in the environment variable CFTIME; see 
environ(S). 


Specifications of native language translations of month and weekday names are 
supported. The language used depends on the value of the environment variable 
LANG; see environ(5). The month and weekday names used for a language are 
taken from strings in the file for that language in the /lib/cftime directory, see 
cftime(4). 


If the argument begins with +, the output of date is under the control of the 
user. All output fields are of fixed size (zero padded if necessary). Each field 
descriptor is preceded by % and is replaced in the output by its corresponding 
value. A single % is encoded by %%. All other characters are copied to the 
output without change. The string is always terminated with a newline character. 


Field Descriptors: 
a abbreviated weekday - Sun to Sat 
A full weekday name 
b abbreviated month name 
B full month name 
d day of month - 01 to 31 
D date as mm/dd/yy 
e day of month - 1 to 31 (single digits are preceded by a blank) 
h abbreviated month - Jan to Dec 
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hour - 00 to 23 

hour - 01 to 12 

day of year - 001 to 366 

month of year - 01 to 12 

minute - 00 to 59 

insert a newline character 

string containing ante-meridiem or post-meridiem indicator (by 

default, AM or PM) 

time in AM/PM notation 

time as hh:mm 

second - 00 to 59 

insert a tab character 

time as HH:MM:SS 

week number of year (Sunday as the first day of the week) - 01 to 52 

day of week - Sunday = 0 

week number of year (Monday as the first day of the week) - 01 to 52 

country-specific date format 

country-specific time format 

last 2 digits of year - 00 to 99 

year as ccyy (four digits) 

timezone name 

Internationalization 
The current date and time can be set and displayed using single- or multibyte 
characters in accordance with the customary local format. Characters from 
supplementary code sets can be used in + format. 


EXAMPLES 
date ’+DATE: %m/%d/%y%unTIME: %H:%M:%S’ 
would have generated as output: 
DATE: 08/01/76 


on  - in- 


NK< eX SE CHT HAD 


TIME: 14:45:05 
DIAGNOSTICS 
No permission if you are not the superuser and you try to change the date; 
bad conversion if the date set is syntactically incorrect; 
bad format character if the field descriptor is not recognizable. 
FILES 
/dev/kmem 
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WARNINGS 
It is a bad practice to change the date while the system is running multiuser. 


SEE ALSO 
cftime(3C) 
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NAME 
dc - desk calculator 


) SYNOPSIS 
de | file ] 


DESCRIPTION 
dc is an arbitrary precision arithmetic package. Ordinarily it operates on decimal 
integers, but one may specify an input base, output base, and a number of 
fractional digits to be maintained. [See bc(1)], a preprocessor for dc providing 
infix notation and a C-like syntax which implements functions and reasonable 
control structures for programs.) The overall structure of dc is a stacking 
(reverse Polish) calculator. If an argument is given, input is taken from that file 
until its end, then from the standard input. All registers are initialized to zero. 
Registers may also be treated as stacks. 


COMMANDS 
number 
Push the value of the number on the stack. A number is an unbroken 
f~ string of the digits 0-9. It may be preceded by an underscore (_) to input 
a negative number. Numbers may contain decimal points. 


taf” « 
Add (+), subtract (-), multiply (*), divide (/), remainder (%), or 
exponentiate (~) the top two values on the stack. Pop the two entries off 
the stack; push the result on the stack in their place. Ignore any fractional 
part of an exponent. 


Pop the top of the stack and store it into a register named x, where x may 
be any character. 


& 


Pop the top of the stack and push it on stack x. 


Push the value in register x on the stack. Register x is not altered. 
Pop the top of stack x and push it onto the main stack. 

Duplicate the top value on the stack. 

Print the top value on the stack. The top value remains unchanged. 


Interpret the top of the stack as an ASCII string, remove it, and print it. 


Sx 
lx 
Lx 
d 
p 
r 
f 
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X 


Exit the program. If executing a string, pop the recursion level by two. 


Pop the top value on the stack and then pop the string execution level by 
that value. 


Treat the top element of the stack as a character string and execute it as a 
string of dc commands. 


Replace the number on the top of the stack with its scale factor. 


[ ..] Push the bracketed ASCII string onto the top of the stack. 


<X xX =x 
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Pop the top two elements of the stack and compare them. Evaluate 
register x if the elements obey the stated relation. 


Repiace the top element on the stack by its square root. Take into 
account any existing fractional part of the argument, but otherwise ignore 
the scale factor. 


Interpret the rest of the line as a UNIX system command. 
Pop all values on the stack. 


Pop the top value on the stack and use it as the number radix for further 
input. 


Push the input base on the top of the stack. 


Pop the top value on the stack and use it as the number radix for further 
output. 


Push the output base on the top of the stack. 


Pop the top of the stack, and use that value as a non-negative scale factor: 
the appropriate number of places are printed on output, and maintained 
during multiplication, division, and exponentiation. The interaction of 
scale factor, input base, and output base is reasonable if all are changed 
together. 


Push the stack level onto the stack. 
Replace the number on the top of the stack with its length. 


Take a line of input from the input source (usually the terminal) and 
execute it. 


Denote array operations. 
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EXAMPLES 
This example prints the first ten values of n!: 
[lal + dsa*pla10 > y|sy 
Osal 
lyx 
SEE ALSO 
bc(1) 


DIAGNOSTICS 
x is unimplemented 
x is an octal number 
stack empty 
not enough elements on the stack to do what was asked 
Out of space 
the free list is exhausted (too many digits) 


Out of headers 
too many numbers being kept around 


Out of stack space 

too many items on the stack 
Nesting Depth 

too many levels of nested execution 
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NAME 
| on, dd - convert and copy a file 


SYNOPSIS 
dd [option= value] ... 


DESCRIPTION 
The dd command copies the specified input file to the specified output with 
possible conversions. The standard input and output are used by default. The 
input and output block size may be specified to take advantage of raw physical 


| VO. 

option values 

if=file input filename; standard input is default 

of =file output filename; standard output is default 

ibs =n input block size n bytes (default 512) 

obs =n output block size (default 512) 

bs =n set both input and output block size, superseding ibs and obs; 
| also, if no conversion is specified, it is particularly efficient since 

f~ no in-core copy need be done 

cbs =n conversion buffer size 

skip=n skip n input blocks before starting copy 

seek =n seek n blocks from beginning of output file before copying 

count=n copy only 7 input blocks 


conv=ascii convert EBCDIC to ASCII 
ebcdic convert ASCII to EBCDIC 
ibm slightly different map of ASCII to EBCDIC 
Icase map alphabetics to lowercase 
ucase map alphabetics to uppercase 
swab swap every pair of bytes 
noerror do not stop processing on an error 
sync _ pad every input block to ibs 
+s yee. Several comma-separated conversions 


Where sizes are specified, a number of bytes is expected. A number may end 
with k, b, or w to specify multiplication by 1024, 512, or 2, respectively; a pair of 
f~ numbers may be separated by x to indicate multiplication. 


cbs is used only if conv= ascii or conv=ebcdic is specified. In the former case, 
cbs characters are placed into the conversion buffer (converted to ASCII). 
Trailing blanks are trimmed and a newline added before sending the line to the 
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output. In the latter case, ASCII characters are read into the conversion buffer 
(converted to EBCDIC). Blanks are added to make up an output block of size 
cbs. 


After completion, dd reports the number of whole and partial input and output 
blocks. 


Internationalization 
dd can process characters from supplementary code sets. 


WARNINGS 
Options 
conv = ebcdic 
conv = asCil 


Conversion results cannot be assurred as characters in supplementary code 
sets are also subject to conversion. 


conv = lIcase 


conv = ucase 
Multibyte characters are not converted. 


DIAGNOSTICS 
f+p blocks in(out) numbers of full and partial blocks 
read(written) 
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NAME 
~~ deroff - remove nroff/troff, tbl, and eqn constructs 


SYNOPSIS 
deroff [-mx] [-w] [ files ] 


DESCRIPTION 
The deroff command reads each of the files in sequence and removes all troff(1) 
requests, macro calls, backslash constructs, eqn (1) constructs (between .EQ and 
.EN lines, and between delimiters), and tb/(1) descriptions, perhaps replacing 
them with white space (blanks and blank lines), and writes the remainder of the 
file on the standard output. deroff follows chains of included files (.so and .nx 
troff commands); if a file has already been included, a .so naming that file is 
ignored and a .nx naming that file terminates execution. If no input file is given, 
deroff reads the standard input. 


The -m option may be followed by an m, s, or |. The -mm option causes the 

macros to be interpreted so that only running text is output (i.e., no text from 

macro lines.) The -ml option forces the -mm option and also causes deletion of 
co lists associated with the mm macros. 


If the -w option is given, the output is a word list, one "word" per line, with all 
other characters deleted. Otherwise, the output follows the original, with the 
deletions mentioned above. In text, a "word" is any string that contains at least 
two letters and is composed of letters, digits, ampersands (&), and apostrophes 
(’); in a macro call, however, a "word" is a string that begins with at least two 
letters and contains a total of at least three letters. Delimiters are any characters 
other than letters, digits, apostrophes, and ampersands. Trailing apostrophes and 
ampersands are removed from "words." 


SEE ALSO 
eqn(1), nroff(1), tbl(1), troff(1) in the DOCUMENTER’S WORKBENCH 
reference manuals | 


BUGS 
deroff is not a complete rroff interpreter, so it can be confused by subtle 
constructs. Most such errors result in too much rather than too little output. 
f \ The -ml option does not handle nested lists correctly. 
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NAME 
c™ df - report number of free disk blocks and i-nodes 


SYNOPSIS 
df [-It] [-f] [file-system | directory | mounted-resource] 


DESCRIPTION 
The df command prints out the number of free blocks and free i-nodes in 
mounted file systems, directories, or mounted resources by examining the counts 
kept in the super-blocks. 


file-system may be specified either by device name (e.g., /dev/dsk/c1d0s2) or by 
mount point directory name (e.g., /usr). 


directory can be a directory name. The report presents information for the device 
that contains the directory. 


mounted-resource can be a remote resource name. The report presents 
information for the remote device that contains the resource. 


a \ If no arguments are used, the free space on all locally and remotely mounted file 
systems is printed. 


The df command uses the following options: 
-1_ _—_— only reports on local file systems. 


-t causes the figures for total allocated blocks and i-nodes to be reported as 
well as the free blocks and i-nodes. 


-f an actual count of the blocks in the free list is made, rather than taking the 
figure from the super-block (free i-nodes are not reported). This option 
does not print any information about mounted remote resources. 


NOTES 
If multiple remote resources are listed that reside on the same file system on a 
remote machine, each listing after the first one is marked with an asterisk. 


FILES 
‘™ /dev/dsk/* 
/etc/mnttab 
SEE ALSO 


mount(1M) in the Administrator’s Reference Manual 
fs(4), mnttab(4) in the Programmer’s Reference Manual 


UP-13525 V1 R1 Page 1 


DF (1M) 


[This page left blank.] 


Page 2 UP-13525 V1 R1 


DIFF (1) 


NAME 
diff - differential file comparator 


SYNOPSIS 
diff [ -efbh | file1 file2 


DESCRIPTION 
The diff command tells what lines must be changed in two files to bring them 
into agreement. If filel (file2) is -, the standard input is used. If file! (file2) is a 
directory, then a file in that directory with the name file2 (file1) is used. The 
normal output contains lines of these forms: 


nl an3,n4 
nin2 dn3 
ni,n2 cn3,n4 


These lines resemble ed commands to convert fileJ into file2. The numbers after 
the letters pertain to file2. In fact, by exchanging a for d and reading backward 
one may ascertain equally how to convert file2 into filel. As in ed, identical 
pairs, where nl = n2 or n3 = n4, are abbreviated as a single number. 


Following each of these lines come all the lines that are affected in the first file 
flagged by <, then all the lines that are affected in the second file flagged by >. 


The -b option causes trailing blanks (spaces and tabs) to be ignored and other 
strings of blanks to compare equal. 


The -e option produces a script of a, c, and d commands for the editor ed, which 
recreates file2 from file]. The -f option produces a similar script, not useful with 
ed, in the opposite order. In connection with -e, the following shell program may 
help maintain multiple versions of a file. Only an ancestral file ($1) and a chain 
of version-to-version ed scripts ($2,$3,...) made by diff need be on hand. A 
"latest version" appears on the standard output. 


(shift; cat $*; echo ’1,$p’) | ed - $1 
Except in rare circumstances, diff finds a smallest sufficient set of file differences. 


Option -h does a fast, half-hearted job. It works only when changed stretches are 
short and well separated, but does work on files of unlimited length. Options -e 
and -f are unavailable with -h. 


FILES 


/usr/lib/diffh for -h 
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SEE ALSO 
bdiff(1), cmp(1), comm(1), ed(1) 


DIAGNOSTICS 
Exit status is 0 for no differences, 1 for some differences, 2 for trouble. 


BUGS 
Editing scripts produced under the -e or -f option are naive about creating lines 
consisting of a single period (.). 


WARNINGS 
Missing newline at end of file X 
indicates that the last line of file X did not have a newline. If the lines are 
different, they are flagged and output; note, however, that the output seems to 
indicate they are the same. 
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NAME 
c~ _diff3 - 3-way differential file comparison 


SYNOPSIS 
diffB [ -ex3 ] filel file2 file3 


DESCRIPTION 
The diff3 command compares three versions of a file, and publishes disagreeing 
ranges of text flagged with these codes: 


all three files differ 


====1 filel is different 
====2 file2 is different 
=== =3 file3 is different 


The type of change suffered in converting a given range of a given file to some 
other is indicated in one of these ways: 


f~, finla Text is to be appended after line number 7/ in file f, 
| where f = 1, 2, or 3. 
fini .nZze Text is to be changed in the range line n/ to line n2. If 


nI = n2, the range may be abbreviated to nJ. 


The original contents of the range follows immediately after a c indication. 
When the contents of two files are identical, the contents of the lower-numbered 
file is suppressed. 


Under the -e option, diff3 publishes a script for the editor ed that incorporates 
into file] all changes between file2 and file3, i.e., the changes that normally would 
be flagged = = = = and = = = =3. Option -x (-3) produces a script to 
incorporate only changes flagged = = = = (= = = =3). The following 
command applies the resulting script to file/. 


(cat script; echo ’1,$p’) | ed - file1 


FILES 
r~ /tmp/d3* 
/usr/lib/diff3 prog 
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SEE ALSO 
diff(1) ; 
BUGS 


Text lines that consist of a single . defeat -e. 
Files longer than 64K bytes won’t work. 
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NAME 
diffmk - mark differences between files 


SYNOPSIS 
diffmk namel name2 name3 


DESCRIPTION 
The diffmk command compares two versions of a file and creates a third file that 
includes change mark commands for nroff or troff(1). namel and name2 are the 
old and new versions of the file. diffmmk generates name3, which contains the 
lines of name2 plus inserted formatter change mark (amc) requests. When name3 
is formatted, changed or inserted text is shown by | at the right margin of each 
line. The position of deleted text is shown by a single * character. 


If the characters | and * are inappropriate, a copy of diffmk can be edited to 
change them (diffmk is a shell procedure). 


EXAMPLES 
The diffmk command can be used to produce listings of C (or other) programs 
with changes marked. A typical command line for such use is: 


diffmk old.c new.c tmp; nroif macs tmp pr 
where the file macs contains: 


.pl 1 
Al 77 
of 
20 


‘N 


NC 


The ll request might specify a different line length, depending on the nature of 
the program being printed. The .eo and .ne requests are probably needed only 
for C programs. 


SEE ALSO 
diff(1), nroff(1) 


RESTRICTIONS 
Aesthetic considerations may dictate manual adjustment of some output. File 
differences, involving only formatting requests, may produce undesirable output, 
i.e., replacing .sp by .sp 2 produces a change mark on the preceding or following 
line of output. 


UP-13525.1 V1 Page 1 


DIFFMK (1) 


[This page left blank.] 


Page 2 UP-13525.1 V1 


DIRCMP (1) 


NAME 
rn dircmp - directory comparison 


SYNOPSIS 
diremp [ -d } [ -s ] [ -wn ] dirl dir2 


DESCRIPTION 
The dircmp command examines dir] and dir2 and generates various tabulated 
information about the contents of the directories. Listings of files that are unique 
to each directory are generated for all the options. If no option is entered, a list 
is Output indicating whether the filenames common to both directories have the 
same contents. 


-d Compare the contents of files with the same name in both directories and 
output a list telling what must be changed in the two files to bring them into 
agreement. The list format is described in diff(1). 


-s Suppress messages about identical files. 


-wn Change the width of the output line ton characters. The default width is 


~*~ 72. 


SEE ALSO 
cmp(1), diff(1) 
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NAME 
du - summarize disk usage 


SYNOPSIS 
du [ -sar | [ names ] 


DESCRIPTION 
The du command reports the number of blocks contained in all files and 
(recursively) directories within each directory and file specified by the names 
argument. The block count includes the indirect blocks of the file. If names 1s 
missing, the current directory is used. 


The optional arguments are as follows: 

-S causes only the grand total (for each of the specified names) to be given. 
-a___— causes an output line to be generated for each file. 

If neither -s or -a is specified, an output line is generated for each directory only. 


-r causes du to generate messages about directories that cannot be be read, 
a \ files that cannot be opened, etc., rather than being silent (the default). 


A file with two or more links is only counted once. 
BUGS 
If the -a option is not used, non-directories given as arguments are not listed. 


If there are links between files in different directories where the directories are 
on separate branches of the file system hierarchy, du counts the excess files more 
than once. 


Files with holes in them get an incorrect block count. (See "File System 
Administration" in the Administration Guide.) 


UP-13525 V1 R1 Page 1 


DU(1M) 


[This page left blank.] 


Page 2 UP-13525 V1 R1 


ECHO(1) 


NAME 
PN echo - echo arguments 


SYNOPSIS 
echo [ arg | ... 


DESCRIPTION 
The echo command writes its arguments separated by blanks and terminated by a 
newline on the standard output. It also understands C-like escape conventions; 
beware of conflicts with the shell’s use of \: 


\b backspace 
\c print line without newline 
\f form-feed 
\n newline 
\r carriage return 
\t tab 
\v vertical tab 
\\ backslash 
f~ \On where 7 is the 8-bit character whose ASCII code is the 1-, 2- or 3- 
digit octal number representing that character. 


echo is useful for producing diagnostics in command files and for sending known 
data into a pipe. 


SEE ALSO 
sh(1) 


CAVEATS 
When representing an 8-bit character by using the escape convention \, the n 
must always be preceded by the digit zero (0). 


For example, typing: echo "WARNING:\07’ prints the phrase WARNING: and 
sounds the "bell" on your terminal. The use of single (or double) quotes (or two 
backslashes) is required to protect the "\" that precedes the "07". 


For the octal equivalents of each character, see ascii(5) in the Programmer’s 
Pot Reference Manual. 
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NAME 
ed, red - text editor 


, SYNOPSIS 
ed [-s] [-p string | [-x] [-C} [file] 
red [-s] [-p string } [-x] [-C] [file] 
DESCRIPTION 
ed is the standard text editor. If the file argument is given, ed simulates an e 


command (see COMMANDS) on the named file; that is, the file is read into the 
ed buffer so that it can be edited. 


-s_ Suppresses the printing of character counts by e, r, and w commands, of 
diagnostics from e and gq commands, and of the ! prompt after a 
Lgshell command. 


-p Allows the user to specify a prompt string. 


-x Encryption option; when used, ed simulates an X command and prompts 
) the user for a key. This key is used to encrypt and decrypt text using the 
c™~ algorithm of crypt(1). The X command makes an educated guess to 
determine whether text read in is encrypted or not. The temporary buffer 
file is encrypted also, using a transformed version of the key typed in for 
the -x option. See crypt(1) and the WARNINGS section at the end of this 
manual page. 


-C_ Encryption option; same as the -x option, except that ed simulates a C 
command. The C command is like the X command, except that all text 
read in is assumed to have been encrypted. 


ed operates on a copy of the file it is editing; changes made to the copy have no 
effect on the file until a w (write) command is given. The copy of the text being 
edited resides in a temporary file called the buffer. There is only one buffer. 


red is a restricted version of ed. It only permits editing of files in the current 
directory. It prohibits executing shell commands via !.gshell command. Attempts 
to bypass these restrictions result in an error message (.grestricted shell). 


~~ Both ed and ved support the fspec (4) formatting capability. After including a 

| format specification as the first line of file and invoking ed with your terminal in 
stty -tabs or stty tab3 mode [see stty(1)], the specified tab stops are automatically 
used when scanning file. For example, if the first line of a file contained: 


<45,10,135 $f: > 
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tab stops would be set at columns 5, 10, and 15, and a maximum line length of 72 
would be imposed. 


NOTE: When you are entering text into the file, this format 1s not in effect; 
instead, because of being in stty -tabs or stty tab3 mode, tabs are expanded to 
every eighth column. 


Commands to ed have a simple and regular structure: zero, one, or two addresses 
followed by a single-character cormmand, possibly followed by parameters to that 
command. These addresses specify one or more lines in the buffer. Every 
command that requires addresses has default addresses, so the addresses can 
often be omitted. 


In general, only one command may appear on a line. Certain commands allow 
the input of text. This text is placed in the appropriate place in the buffer. 
While ed is accepting text, it is said to be in input mode. In this mode, no 
commands are recognized, all input is merely collected. Leave input mode by 
typing a period (.) at the beginning of a line, followed immediately by a carriage 
return. 


REGULAR EXPRESSIONS (REs) 
ed supports a limited form of regular expression notation. Regular expressions 
are used in addresses to specify lines and, in some commands (e.g., 5), to specify 
portions of a line that are to be substituted. A regular expression (RE) specifies 
a set of character strings. A member of this set of strings is said to be matched 
by the RE. The REs allowed by ed are constructed as follows: 


The following one-character REs match a single character: 


1.1 An ordinary character (not one of those discussed in 1.2) is a one-character 
RE that matches itself. 


1.2 A backslash (\) followed by any special character is a one-character RE 
that matches the special character itself. The special characters are: 


a. . *{[ and \ (period, asterisk, left square bracket, and backslash, 
respectively), which are always special, except when they appear within 
square brackets ([]) (see 1.4). 


b. ~ (caret or circumflex), which is special at the beginning cf an entire 
RE (see 3.1 and 3.2), or when it immediately follows the left of a pair 
of square brackets ([]) (see 1.4). 


c. $ (dollar sign), which is special at the end of an entire RE (see 3.2). 
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d. The character used to bound (1.e., delimit) an entire RE, which is 
special for that RE (for example, see how slash (/) is used in the g 
command). 


A period (.) is a one-character RE that matches any character except 
newline. 


A non-empty string of characters enclosed in square brackets ([]) is a 
one-character RE that matches any one character in that string. If, 
however, the first character of the string is a circumflex (“), the one- 
character RE matches any character except newline and the remaining 
characters in the string. The ~ has this special meaning only if it occurs 
first in the string. The "-" (minus) may be used to indicate a range of 
consecutive ASCII characters; for example, [0-9] is equivalent to 
[0123456789]. The "-" loses this special meaning if it occurs first (after an 
initial “, if any) or last in the string. The ] (right square bracket) does not 
terminate such a string when it is the first character within it (after an 
initial “, if any); for example, []a-f] matches either a ] or one of the 
letters a through f inclusive. The four characters previously listed in 1.2.a 
stand for themselves within such a string of characters. 


The following rules may be used to construct REs from one-character REs: 


ouk 


Le 


Lad 


2.4 


fi 


2.6 


A one-character RE is an RE that matches whatever the one-character RE 
matches. 


A one-character RE followed by an asterisk (*) is an RE that matches zero 
or more occurrences of the one-character RE. if there is any choice, the 
longest leftmost string that permits a match is chosen. 


A one-character RE followed by \{.gm\}, \{.gn, \}, or \{.g77,7 \} is an 
RE that matches a range of occurrences of the one-character RE. The 
values of 7 andn must be non-negative integers less than 256; \{.grm \} 
matches exactly m occurrences; \{.grn, \} matches at least m occurrences; 
\{.g7,n\} matches any number of occurrences between m and n inclusive. 
Whenever a choice exists, the RE matches as many occurrences as possible. 


The concatenation of REs is an RE that matches the concatenation of the 
strings matched by each component of the RE. 


An RE enclosed between the character sequences \( and \) is an RE that 
matches whatever the unadorned RE matches. 


The expression \.gn matches the same string of characters as was matched 
by an expression enclosed between \( and \) earlier in the same RE. Here 
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n 1s a digit; the sub-expression specified is that beginning with the n-th 
occurrence of \( counting from the left. For example, the expression 
~\(.4\)\1$ matches a line consisting of two repeated appearances of the 
same string. 


Finally, an entire RE may be constrained to match only an initial segment or final 
segment of a line (or both). 


3.1 A circumflex (~) at the beginning of an entire RE constrains that RE to 
match an initial segment of a line. 


3.2 A dollar sign ($) at the end of an entire RE constrains that RE to match a 
final segment of a line. 


The construction “.gentire RE$ constrains the entire RE to match the entire 
line. 


The null RE (e.g., //) is equivalent to the last RE encountered. See the last 
paragraph before FILES. 


ADDRESSES 


To understand addressing in ed it is necessary to know that at any time there is a 
current line. Generally speaking, the current line is the last line affected by a 
command; the exact effect on the current line is discussed under the description 
of each command. Addresses are constructed as follows: 


1. The.character addresses the current line. 
2. The $ character addresses the last line of the buffer. 
A decimal number n addresses the n-th line of the buffer. 


- 


mark name character x, which must be an ASCII lowercase letter (a-z). 
Lines are marked with the k command (see COMMANDS). 


5. An RE enclosed by slashes (/) addresses the first line found by searching 
forward from the line following the current line toward the end of the buffer 
and stopping at the first line containing a string matching the RE. If 
necessary, the search wraps around to the beginning of the buffer and 
continues up to and including the current line, so that the entire buffer is 
searched. See the last paragraph before FILES. 


6. An RE enclosed in question marks (?) addresses the first line found by 
searching backward from the line preceding the current line toward the 
beginning of the buffer and stopping at the first line containing a string 
matching the RE. If necessary, the search wraps around to the end of the 
buffer and continues up to and including the current line. See the iast 
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paragraph before FILES. 


~*~ 7. An address followed by a plus sign (+) or a minus sign (-) followed by a 
re decimal number specifies that address plus (respectively minus) the 
indicated number of lines. The plus sign may be omitted. 


8. If an address begins with + or -, the addition or subtraction is taken with 
respect to the current line; e.g, -5 is understood to mean .-5. 


9. If an address ends with + or -, then 1 is added to or subtracted from the 
address, respectively. As a consequence of this rule and of Rule 8, the 
address "=" refers to the line preceding the current line. (To maintain 
compatibility with earlier versions of the editor, the character ~ in 
addresses is entirely equivalent to "-".) Moreover, trailing + and - 
characters have a cumulative effect, so -- refers to the current line jess 2. 


10. For convenience, a comma (,) stands for the address pair 1,$, while a 
semicolon (;) stands for the pair .,$. 


Commands may require zero, one, or two addresses. Commands that require no 
: addresses regard the presence of an address as an error. Commands that accept 
a. one or two addresses assume default addresses when an insufficient number of 
addresses is given; if more addresses are given than such a command requires, 
the last ones are used. 


Typically, addresses are separated from each other by a comma (,). They may 
also be separated by a semicolon (;). In the latter case, the current line (.) is set 
to the first address, and only then is the second address calculated. This feature 
can be used to deterinine the starting line for forward and backward searches 
(see Rules 5 and 6). The second address of any two-address sequence must 
correspond to a line that follows, in the buffer, the line corresponding to the first 
address. 


COMMANDS 
In the following list of ed commands, the default addresses are shown in 
parentheses. The parentheses are not part of the address; they show that the 
given addresses are the default. 


rf» It is generally illegal for more than one command to appear on a line. However, 

| any command (except e, f, r, or w) may be suffixed by 1, n, or p in which case the 
current line is either listed, numbered or printed, respectively, as discussed below 
under the /, », and p commands. 
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(.)a 

< text > 
The append command reads the given text and appends it after the 
addressed line. The (.) is left at the last inserted line, or if there is none, at 
the addressed line. Address 0 is legal for this command: it causes the 
"appended" text to be placed at the beginning of the buffer. The maxmum 
number of characters that may be entered from a terminal is 256 per line 
(including the newline character). 

(.)e 

< text> 
The change command deletes the addressed lines then accepts input text 
that replaces these lines. The (.) is left at the last line input or, if there is 
none, at the first line that was not deleted. 

C 


Same as the X command, except that ed assumes all text read in for the e 
and r commands is encrypted unless a null key is typed in. 


Foose 
The delete command deletes the addressed lines from the buffer. The line 
after the last line deleted becomes the current line; if the lines deleted were 
originally at the end of the buffer, the new last line becomes the current 
line. 


e file 


The edit command causes the entire contents of the buffer to be deleted, 


and the named file to be read in. The (.) is set to the last line of the buffer. 


if no filename is given, the currently remembered filename, if any, is used 
(see the f command). The number of characters read 1s typed and file is 
remembered for possible use as a default filename in subsequent e, r, and 
w commands. If file is replaced by !, the rest of the line is taken to be a 
shell [.gsh (1)] command whose output is to be read. Such a shell command 
is not remembered as the current filename. See DIAGNOSTICS. 


E file 
The Edit command is like e, except that the editor does aot check to see if 
any changes have been made to the buffer since the last w command. 


f file 
If file is given, the filename command changes the currently remembered 
filename to file; otherwise, it prints the currently remembered filename. 
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(1,$)g/RE/command list 
In the global command, the first step is to mark every line that matches the 
a given RE. Then, for every such line, the given command list is executed 
with (.) initially set to that line. A single command or the first of a list of 
commands appears on the same line as the global command. All lines of a 
multi-line list (except the last line) must be ended with a \ character; a, 1, 
and c commands and associated input are permitted. The (-) terminating 
input mode may be omitted if it would be the last line of the command list. 
An empty command list is equivalent to the p command. The g, G, v, and 
V commands are not permitted in the command list. See RESTRICTIONS 
and the last paragraph before FILES. 


(1,$)G/RE/ 
In the interactive Global command, the first step is to mark every line that 
matches the given RE. Then, for every such line, that line is printed, (.) is 
changed to that line, and any one command (other than one of the a,c, #, 
g, G, v, and V commands) may be input and is executed. After the 
execution of that command, the next marked line is printed, and so on. A 
~~ newline acts as a null command and an & causes the re-execution of the 
most recent command executed within the current invocation of G. Note 
that the commands input as part of the execution of the G command may 
address and affect any lines in the buffer. The G command can be 
terminated by an interrupt signal (ASCII DEL or BREAK). 


h 
The help command gives a short error message that explains the reason for 
the most recent ? diagnostic. 

H 
The Help command causes ed to enter a mode in which error messages are 
printed for all subsequent ? diagnostics. It also explains the previous ? if 
there was one. The H command alternately turns this mode on and off; it 
is initially off. 

(.)i 

< text > 

ae The insert command inserts the given text before the addressed line. The 


(.) is left at the last inserted line or, if there is none, at the addressed line. 
This command differs from the a@ command only in the placement of the 
input text. Address 0 is not legal for this command. The maximum number 
of characters that may be entered from a terminal is 256 per line (including 
the newline character). 
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(.,.+1)j 
The join command joins contiguous lines by removing the appropriate 
newline characters. If exactly one address is given, this command does 
nothing. 


(.)kx 
The mar.gk command marks the addressed line with name x, which must be 
an ASCII lowercase letter (a-z). The address .g’x then addresses this line. 
The (.) is unchanged. 


(age )l 
The /ist command prints the addressed lines in an unambiguous way: a few 
non-printing characters (e.g., tab, backspace) are represented by visually 
mnemonic overstrikes. All other non-printing characters are printed in 
octal, and long lines are folded. An / command may be appended to any 
command other than e, f, 7, or w. 


(.,.)ma 
The move command repositions the addressed line(s) after the line 
addressed by a. Address 0 is legal for a and causes the addressed line(s) 
to be moved to the beginning of the file. It is an error if address a falls 
within the range of moved lines. The (.) is left at the last line moved. 


(.,.)D 
The number command prints the addressed lines, preceding each line by its 
line number and a tab character. The (.) is left at the last line printed. The 
n command may be appended to any command other than e, f, r, or w. 


(.,-)p 
The print command prints the addressed lines. The (.) is left at the last 
line printed. The p command may be appended to any command other 
than e, f, r, or w. For example, .gdp deletes the current line and prints the 
new current line. 


P 
The editor prompts with a * for all subsequent commands. The P 
command alternately turns this mode on and off; it is initially off. 

q 
The quit command causes ed to exit. No automatic write of a file is done 
however. See DIAGNOSTICS. 

Q 


The editor exits without checking if changes have been made in the buffer 
since the last w command. 
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($ )r file 


The read command reads in the given file after the addressed line. If no 
filename is given, the currently remembered filename, if any, is used (see 
the e and f commands). The currently remembered filename is not 
changed unless file is the first filename mentioned since ed was invoked. 
Address 0 is legal for r and causes the file to be read at the beginning of 
the buffer. If the read is successful, the number of characters read is typed 
and (.) is set to the last line read in. If file is replaced by !, the rest of the 
line is taken to be a shell [.gsh(1)] command whose output is to be read. 
For example, "Sr !Is" appends the current directory to the end of the file 
being edited. Such a shell command is not remembered as the current 
filename. 


(.,.)s/RE/replacement/ or 
(.,.)s/RE/replacement/g or 
(.,.)s/RE/replacement/n n= 1512 


The substitute command searches each addressed line for an occurrence of 
the specified RE. In each line in which a match is found, all (non- 
overlapped) matched strings are replaced by the replacement if the global 
replacement indicator g appears after the command. If the global indicator 
does not appear, only the first occurrence of the matched string is replaced. 
If a number 7 appears after the command, only the nth occurrence of the 
matched string on each addressed line is replaced. It is an error for the 
substitution to fail on al] addressed lines. Any character other than space 
or newline may be used instead of / to delimit the RE and the replacement. 
The (.) is left at the last line on which a substitution occurred. See the last 
paragraph before FILES. 


An ampersand (&) appearing in the replacement is replaced by the string 
matching the RE on the current line. The special meaning of & in this 
context may be suppressed by preceding it by \. As a more general feature, 
the characters \.gn, where n is a digit, are replaced by the text matched by 
the nth regular sub-expression of the specified RE enclosed between \( and 
\). When nested parenthesized sub-expressions are present, n is 
determined by counting occurrences of \( starting from the left. When the 
character % is the only character in the replacement, the replacement used 
in the most recent substitute command is used as the replacement in the 
current substitute command. The % loses its special meaning when it is in a 
replacement string of more than one character or is preceded witha \ 
character. 
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A line may be split by substituting a newline character into it. The newline 
in the replacement must be escaped by preceding it with a \ character. 
Such substitution cannot be done as part of a g or v command list. 


(sas J 


This command acts just like the m command, except that a copy of the 
addressed lines is placed after address a (which may be 0). The (.) is left 
at the last line of the copy. 


The undo command nullifies the effect of the most recent command to 
modify anything in the buffer, namely the most recent a,c, d, g,i,]j,m,71, 5, 
t,v, G, or V command. 


(1,$)wW/RE/command list 


This command is the same as the global command g except that the 
command list is executed with (.) initially set to every line that does not 
match the RE. 


(1,$)V/RE/ 


This command is the same as the interactive global command G except that 
the lines that are marked during the first step are those that do not match 
the RE. 


(1,$)w file 
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The write command writes the addressed lines into the named file. If the 
file does not exist, it is created with mode 666 (readable and writable by 
everyone) unless your wnask setting [see wnask(1)] dictates otherwise. The 
currently remembered filename is not changed unless file is the first 
filename mentioned since ed was invoked. If no filename is given, the 
currently remembered filename, if any, is used (see the e and f commands). 
The (.) is unchanged. If the command is successful, the number of 
characters written is typed. If file is replaced by !, the rest of the line is 
taken to be a shell [.gsh(1)] command whose standard input is the 
addressed lines. Such a shell command is not remembered as the current 
filename. 


A key is prompted for and is used in subsequent e, 7, and w commands to 
decrypt and encrypt text using the crypt(1) algorithm. An educated guess is 
made to determine whether text read in for the e and r commands is 
encrypted. A null key turns encryption off. Subsequent e, r, and w 
commands use this key to encrypt or decrypt the text [see crypt(1)]. An 
explicitly empty key turns off encryption. Also, see the -x option of ed. 


UP-13525.1 V1 


ED(1) 


($)= 
The line number of the addressed line is typed. The (.) is unchanged by 


f \ this command. 


shell command 
The remainder of the line after the ! is sent to the UNIX system shell 
[.gsh (1)] to be interpreted as a command. Within the text of that command, 
the unescaped character % is replaced with the remembered filename. If a | 
! appears as the first character of the shell command, it is replaced with the | 
text of the previous shell command. Thus, !! repeats the last shell 
command. If any expansion is performed, the expanded line is echoed. 
The (.) is unchanged. | 


(.+1)<newline> 
An address alone on a line causes the addressed line to be printed. A | 
newline alone is equivalent to .+1p; it is useful for stepping forward | 
through the buffer. 


HINTS 
oo If an interrupt signal (ASCII DEL or BREAK) is sent, ed prints a ? and returns 
to its command level. | 


Size limitations: 512 characters in a line, 256 characters in a global command list, 
and 64 characters in the pathname of a file (counting slashes). The limit on the 
number of lines depends on the amount of user memory: each line takes 1 word. 


When reading a file, ed discards ASCII NUL characters. 


If a file is not terminated by a newline character, ed adds one and sends out a 
message explaining what it did. 


If the closing delimiter of an RE or of a replacement string (e.g., /) is the last 
character before a newline, that delimiter may be omitted. In this case the 
addressed line is printed. The following pairs of commands are equivalent: 


s/s1/s2 s/s1/s2/p 
g/s1 g/si/p 


r™ ?s1 21? 


Internationalization 
ed can process characters from supplementary code sets as well as ASCII 
characters. | 
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Searches and pattern matching with regular expressions are performed in 
character units, not in individual bytes. 


Matches any EUC character. 
* Matches zero or more occurrances of the given regular expression. 
.* Matches any character string including the null string. 


[] Matches any one character in the string enclosed by square brackets, or 
any one character with a code value within the range designated using a 
minus (-) sign. When the characters in the range are from different code 
sets, one of the characters specifying the range is matched. See ed(1). 


[*] Excludes the specified character from all EUC characters matched. 


A prompt string containing characters from supplementary code sets can be 
designated in string using the -p option. 


Marks set by the k command must be ASCII lowercase letters. 


FILES 
$TMPDIR _ if this environmental variable is not null, its value is used in place 
of /usr/tmp as the directory name for the temporary work file. 


/usr/tmp if /usr/tmp exists, it is used as the directory name for the 
temporary work file. 


/tmp if the environmental variable TMPDIR does not exist or is null, and 
if /usr/tmp does not exist, then /tmp is used as the directory name 
for the temporary work file. 

ed.hup work is saved here if the terminal is hung up. 


NOTES 
The "-" option, although it continues to be supported, has been replaced in the 
documentation by the -s option. 


SEE ALSO 
edit(1), ex(1), grep(1), sed(1), sh(1), stty(1), umask(1), vi(1) 
fspec(4), regexp(5) in the Programmer’s Reference Manual 


DIAGNOSTICS 
? for command errors. 
file for an inaccessible file. 


(use the help and Help commands for detailed explanations). 
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If changes have been made in the buffer since the last w command that wrote the 
entire buffer, ed warns the user if an attempt is made to destroy ed’s buffer via 
the e or g commands. It prints ? and allows one to continue editing. A second e 
or g command at this point takes effect. The -s command-line option inhibits 
this feature. 


WARNINGS 
The encryption options and commands are provided with the Crypt Utilities 
package, which is available only in the United States. 


The size of the file displayed at first and after read/write by the e, r, and w 
commands is in bytes, not characters. 


RESTRICTIONS 
A / command cannot be subject to a g or a vy command. 


The / command and the ! escape from the e, r, and w commands cannot be used 
if the editor is invoked from a restricted shell [see sh (1)]. 


The sequence \n in an RE does not match a newline character. 


If the editor input is coming from a command file (e.g., ed file < ed-cmd-file), 
the editor exits at the first failure. 
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[This page left blank.] 
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NAME 
edit - text editor (variant of ex for casual users) 


SYNOPSIS 
edit [ -L ][ -C ] [ -r [file]][ -x ] file ... 


DESCRIPTION 
The edit command is a variant of the text editor ex. It is recommended for new 
or casual users who wish to use a command-oriented editor. 


OPTIONS 
| -L__ List the name of all files saved as a result of an editor or system crash. 


-C Encryption option; same as the -x option except that edit simulates the 
"less-than-or-equal" command of ex(1) and all text read in is assumed to 
have been encrypted. 


-r Recover file after an editor or system crash. If file is not specified, a list of 
all saved files is printed. 


-x Encryption option; the file is encrypted as it is being written and requires 
an encryption key to be read [see crypt(1)]. 


The following brief introduction should help you get started with edit. 


BASIC EDIT COMMANDS 
edit 
To edit the contents of a file, enter the shell command 
edit fname 


where fname is the name of an existing file or a file you wish to create. (To enter 
a command, type the command then press < cr > or newline.) edit copies the 
file fname into the edit buffer and prints a file size message indicating how many 
lines and characters are in the edit buffer. If fname is a new file, edit prints 
fname followed by [ Newfile ]. After printing the new file or file size message, 
edit prompts for a command with a colon. 


current line, print, and delete 
Most edit commands affect the current line in the buffer if you do not specify 
another line or lines in the command. For example, if you enter 


print 


or its abbreviated form p, edit prints the current line. To move the current line 
down a line, press newline; edit prints the new current line. 
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To delete the current line, enter d. The edit command deletes the line and prints 
the new current line. When edit is first entered, the current line is the last line of 
the file. If you delete this last line, the new last line of the file becomes the 
current line. In all other cases, the line after the deleted line becomes the current 
line. 


edit numbers the lines in the buffer; the first line has number 1. If you enter 1, 
edit prints the first line. Enter d and edit deletes the first line, line 2 becomes 
line 1, and edit prints the current line (the new line 1). 


append and insert 
To add lines to a newly created file, or to an existing file, use the append (a) 
command. Enter a, and edit reads subsequent lines from your terminal into the 
file, adding these new lines after the current line. To signal the end of the input 
lines, enter a period on a line by itself. The last line entered before the period 
becomes the new current line. 


The insert (i) command works just like append but edit places the input lines 
before the current line, rather than after it. 


substitute 
To change some text within the current line, use the substitute (s) command. 
Enter s/oldtext /newtext/ where oldtext is the old characters you want to replace 
with the new characters, newtext. 


To delete some characters, use the substitute command as follows: s/oldtext // 
where oldtext is the text you want to delete. 


file, write, and quit 
The file (f) command prints the number of lines in the edit buffer and sends the 
message: modified if the buffer has been changed. 


To replace the file with the buffer text (i.e., to save the changes) enter a write (w) 
command. You may then leave the editor using the quit (q) command. If you 
edit a file, but make no changes to it, it is not necessary (but does no harm) to 
write the file. 


If you try to quit edit after modifying the buffer without writing the file, edit warns 
that there has been No write since last change. If you do not wish to save the 
changes in the edit buffer, enter the quit! or q! command. edit discards the 
buffer (irretrievably) and you return to the shell. 
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OTHER COMMANDS ; 
The basic commands listed above are adequate for making most changes. If you 
a intend to use edit more than a few times, however, it is useful to know more 
| commands. 


change and line ranges 
The change (c) command changes the current line to a sequence of lines you 
supply (as in append you enter a sequence of lines ending with a line consisting 
of only a period). 


_ change changes more than one line if you specify the line numbers of the lines 
you want to change. For example, 3,5change changes lines 3 through 5 to the 
lines you supply. The line range also works in other commands; 1,20p prints the 
first 20 lines of the file. 


undo 
The undo (u) command reverses the effect of the last command to change the 
contents of the buffer (not necessarily the current line). For example, if a 
substitute command does not do what you intended, enter undo; edit restores the 
old contents of the line. You can also undo an undo command if you continue to 


( \ change your mind. 


edit prints a message when a command (including undo) affects more than one 
line of the buffer. If the amount of change seems unreasonable, you should 
consider doing an undo and looking to see what happened. If you decide that 
the change is ok, then you can undo again to get it back. 


NOTE: Commands such as write and quit cannot be undone. 


< Ctrl > D and_-z (viewing lines) and count 
There are two ways to look at several lines in the buffer: < Ctrl > D and z. 


< Ctrl > D is executed by holding down the Ctrl key and and pressing the D 
key (the Ctrl key is similar to the shift key). It prints the next half screen of lines 
on a CRT or the next 12 lines on a hardcopy terminal. 


The z command is a more versatile way to view several lines. z. clears the screen 
and prints a full screen of lines with the current line near the center of the 
screen. The last line printed becomes the new current line. z- prints the 
cr screenful of lines which precede the current line, printing the current line last. 
ew z+ prints the screenful of lines which follow the current line. 


To view less that a screenful of lines, append the number of lines you wish to 
view to z- or z+. For example, z+5 prints the next five lines; 5 is the count of 
lines. 
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count works for other commands too; delete 5, for example, deletes five lines 
beginning with the current line. si 


and ? (search) a 


To locate strings in the file you can use line numbers if you know them; but the 
line numbers change when you insert and delete lines, so the correct line number 


may be difficult to remember. It may be easier to search for the strings using / or 
9) 


e@e 


~~ 


/text/ searches forward for text; ?text? searches backward for text. If either search 
encounters the end of the file in its direction without finding fext, the search 
wraps around to the other end of the file and continues to search back to the 
current line. The line where fext is found becomes the new current line. 


A useful feature is a search of the form /~* text/ which searches for fext at the 
beginning of a line. Similarly /text$/ searches for text at the end of a line. 


You can leave off the trailing / or ? in these commands. 


special line numbers 
The current line is symbolized by the period, and the last line of the file is ) 
symbolized by the $ symbol. This shorthand is useful in expressing line ranges in WY 
commands, such as .,$print, which prints the lines from the current line through 7 
the last line. Arithmetic line references are also possible: line $-5 is the fifth line 
before the last line, and line .+20 is the line 20 lines after the current line. 


copying and moving text 
There are two ways to move and copy text: with buffers and without buffers. 
Copying or moving text from one file to another requires the use of buffers; 
moving text around within a file does not. Both ways, however, require that you 
know the line numbers of the first and last lines of the text you are going to 
move. 


To move some text from one place in a file to another, you can use the move 

command. For example, 1,5move$ moves lines 1 through 5 to the end of the file. 

To copy text within a file, you can use the copy command. 1,5copyl0 puts a copy 

of the first five lines of the file after line 10. These commands are 

straightforward, but they have a drawback: you must know exactly where the lines 

are going before you can move or copy them, and if you move them to the wrong i> 
place, you must use the undo command and do the command over again, or 

figure out the new line numbers. 
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Buffering is a more versatile way of moving text. edit has 26 buffers named a 
through z. Text put into these buffers can be copied out of the buffers any time 
before you exit edit; you do not have to know the destination of the text when you 
put it into the buffer. 


To copy text into the buffer, use the yank command. 
"1,5yank t" 
copies lines 1 through 5 into buffer t. 


To move text into a buffer, deleting the lines from the file, use the delete 
command followed by the buffer name. 1,5d z moves lines 1 through 5 into 
buffer z. 


To copy the buffered text back into the file, use the put command. put z, for 
example, copies the contents of buffer z after the current line. To copy the 
buffered text into a second file, you must edit that file. If you made any changes 
to the current file that you want to save, enter write before using edit. If you do 
not wish to save the changes, use edit!. In either case, enter edit fname (or edit! 
fname) where fname is the name of the file where the buffered text is to be 
copied. Once in the other file, put the text as usual. 


NOTE: The buffer contents change only when a new yank or delete directs lines 
to the buffer. When edit is exited (i.e. a quit is issued) the buffer contents are 
lost. 


SEE ALSO 
ex(1), vi(1) 


RESTRICTIONS 


See ex(1) 
The crypt feature ( -x option) is available only in the United States. 
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NAME 
o egrep - search a file for a pattern using full regular expressions 


SYNOPSIS 
egrep [options] full regular expression [file ...] 


DESCRIPTION 
The egrep (expression grep) command searches files for a pattern of characters 
and prints all lines that contain that pattern. egrep uses full regular expressions 
(expressions that have string values that use the full set of alphanumeric and 
special characters) to match the patterns. It uses a fast deterministic algorithm 
that sometimes needs exponential space. 


egrep accepts full regular expressions as in ed(1), except for \( and \), with the 


addition of: 
1, A full regular expression followed by + that matches one or more 
occurrences of the full regular expression. 
2. A full regular expression followed by ? that matches 0 or 1 occurrences of 
rf~ the full regular expression. 
4s Full regular expressions separated by } or by a newline that match strings 


that are matched by any of the expressions. 
4, A full regular expression that may be enclosed in parentheses () for 
grouping. 
Be careful using the characters $, *, [, ~, |, ( ), and \ in full regular expression, 
because they are also meaningful to the shell. It is safest to enclose the entire full 
regular expression in single quotes ’...’. 


The order of precedence of operators is [], then *? +, then concatenation, then 
' and newline. | 


If no files are specified, egrep assumes standard input. Normally, each line found 
is copied to the standard output. The filename is printed before each line found 
if there is more than one input file. 


Command line options are: 


r~ -b Precede each line by the block number on which it was found. This can 
be useful in locating block numbers by context (first block is 0). 
Cc Print only a count of the lines that contain the pattern. 
-i Ignore uppercase/lowercase distinction during comparisons. 
-l Print the names of files with matching lines once, separated by newlines. 
Does not repeat the names of files when the pattern is found more than 
once. 
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-n Precede each line by its line number in the file (first line is 1). 
-V Print all lines except those that contain the pattern. 
-€ special expression | 
Search for a special expression (full regular expression that begins with a -). 
-ffile Take the list of full regular expressions from file. 


Internationalization 
egrep can process characters from supplementary code sets. In regular 
expressions, searches are performed on characters, not on individual bytes. 
Options: 


-i_ Ignore upper/lowercase distinction during comparisons; valid for single byte 
characters only. 


SEE ALSO 
ed(1), fgrep(1), grep(1), sed(1), sh(1) 
_ DIAGNOSTICS 
Exit status is 0 if any matches are found, 1 if none, 2 for syntax errors or 
inaccessible files (even if matches were found). w/ 
BUGS 


Ideally there should be only one grep command, but there is not a single 
algorithm that spans a wide enough range of space-time tradeoffs. Lines are 
limited to BUFSIZ characters; longer lines are truncated. BUFSIZ is defined in 
/usr/include/stdio.h. 
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NAME 
enable, disable - enable/disable LP printers 


SYNOPSIS 
enable printers 
disable [-c] [-r[reason]] printers 


DESCRIPTION 
The enable command activates the named printers, enabling them to print 
requests taken by /p(1). Use /pstat(1) to find the status of printers. 


disable deactivates the named printers, disabling them from printing requests 
taken by /p(1). By default, any requests that are currently printing on the 
designated printers are reprinted in their entirety either on the same printer or 
on another member of the same class. Use /pstat(1) to find the status of printers. 
Options useful with disable are: 


-C Cancel any requests that are currently printing on any of the 
designated printers. 


-r[reason] Associates a reason with the deactivation of the printers. This 
reason applies to all printers mentioned up to the next -r option. If 
the -r option is not present or the -r option is given without a 
reason, then a default reason is used. Reason is reported by 


Ipstat(1). 
FILES 
/usr/spool/1p/* 
SEE ALSO 


Ip(1), Ipstat(1) 
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NAME 
env - set environment for command execution 

SYNOPSIS | 
env [-] [ name=value ] .... [ command args | | 


DESCRIPTION | 
The env command obtains the current environment, modifies it according to its | 
arguments, then executes the command with the modified environment. 
Arguments of the form name =value are merged into the inherited environment 
before the command is executed. The - flag causes the inherited environment to 
be ignored completely, so that the command is executed with exactly the 
environment specified by the arguments. 


If no command is specified, the resulting environment is printed, one name-value 
pair per line. 


SEE ALSO 
sh(1) 
exec(2), profile(4), environ(5) in the Programmer’s Reference Manual 
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NAME 
eqn, neqn, checkeq — format mathematical text for nroff or troff 


SYNOPSIS 
eqn [ —dxy ] [ -pn ] [ -sn ] [ -fn ] [ —Tdest ] [ files ] 


neqn [ -dxy ] [ —pn ] [ -sn ] [ -fn ] [ files ] 
checkeq [ files ] 


DESCRIPTION 
eqn is a troff(1) preprocessor for typesetting mathematical text on a phototypesetter; 
neqn is used for the same purpose with nroff(1) on typewriter-like terminals. Usage 
is almost always: 


eqn files | troff 
negn files | nroff 


If no files are specified, or if "-" is specified as the last argument, eqn and neqn read 
the standard input. 


A line beginning with .EQ marks the start of an equation; the end of an equation is 
marked by a line beginning with .EN. Neither of these lines is altered, so they may 
be defined in macro packages to get centering, numbering, etc. It is also possible to 
designate two characters as delimiters; subsequent text between delimiters is then 
treated as eqn input. Delimiters may be set to characters x and y with delim xy 
between .EQ and .EN (see also option —d). The left and right delimiters may be the 
same character; the dollar sign is often used as such a delimiter. Delimiters are 
turned off by delim off. All text that is neither between delimiters nor between .EQ 
and .EN is passed through untouched. 


checkeq reports missing or unbalanced delimiters and .EQ/.EN pairs. 


Tokens within eqn are separated by spaces, tabs, new-lines, braces, double quotes, 
tildes, and circumflexes. Braces { } are used for grouping; generally speaking, any- 
where a single character such as x could appear, a complicated construction enclosed 
in braces may be used instead. Tilde (~) represents a full space in the output, 
circumflex (4) half as much. 


Subscripts and superscripts are produced with the keywords sub and sup: 


x sub j makes Xj 
a sub k sup 2 makes at 
e sup {x sup 2 + y sup 2} makes ex” 
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Fractions are made with over: 
a over b 


makes 


© 


a 


b 
sqrt makes square roots: 


I over sqrt {ax sup 2+bx+c} 


makes 
1 


inet +¢ 


The keywords from and to introduce lower and upper limits: 
lim from {n —> inf} sum from 0 to nx subi 


makes 


lim be ‘> 

= WY 
Left and right brackets, braces, etc., of the right height are made with left and right: 

left [ x sup 2 + y sup 2 over alpha right ] = 1 


makes 


y) 
oO 
Valid characters after left and right are braces, brackets, bars, c and f for ceiling and 


floor, and "" for nothing at all (useful for a right-side-only bracket). A left bracket- 
ing Character need not have a matching right bracketing character. 


Vertical piles of things are made with pile, Ipile, cpile, and rpile: 
pile {a above b above c} 


Y 
b 
C 


Piles may have arbitrary numbers of elements; Ipile left-justifies, pile and cpile 
center (but with different vertical spacing), and rpile right justifies. 


makes 
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Matrices are made with matrix: 

matrix { lcol { x sub i above y sub 2 } ccol { 1 above 2 } } 
makes 

x; 1 

y2 2 
In addition, there is rcol for a right-justified column. 


Diacritical marks are made with dot, dotdot, hat, tilde, bar, vec, dyad, and under: 
x dot = f(t) bar makes =f (1) 
y dotdot bar = n under makes y 
x vec = y dyad makes x= 


Point sizes and fonts can be changed with size n or size tn, roman, italic, bold, and 
font n. Point sizes and fonts can be changed globally in a document by gsize n and 
gfont n, (see also options —s and —f). 


Normally, subscripts and superscripts are reduced by 3 points from the previous size 
(see option —p). 


Successive display arguments can be lined up. Place mark before the desired lineup 
point in the first equation; place lineup at the place that is to line up vertically in 
subsequent equations. 


Shorthands may be defined or existing keywords redefined with define: 
define token % text % 


defines a token called token that will be replaced by text whenever it appears 
thereafter. The % may be any character that does not occur in replacement. 


Keywords such as sum (>>), int (f), inf (cc), and shorthands such as >= (2), != (4), 
and —> (—>) are recognized. Greek letters are spelled out in the desired case, as in 
alpha (a), or GAMMA (I). Mathematical words such as sin, cos, and log are made 
Roman automatically. Troff(1) four-character escapes such as \(dd (¢) and \(co (©) 
may be used anywhere. Strings enclosed in double quotes are passed through 
untouched; this permits keywords to be entered as text, and can be used to communi- 
cate with troff(1) when all else fails. 
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OPTIONS 


—dxy Set x as the left delimiter and y as the nght delimiter for egn text. 


—sn Set n to be the point size for the document. 
—fn Set 1 to be the font number for the document. 
-—pn Reduce point size by n for the subscripts and superscripts. 


-Tdest Prepare output for the typesetter dest.option. Supported devices are —-Taps 
(Autologic APS-5), -TX97 (Xerox 9700), -Til0 (Imagen Imprint-10), and 


~Tcat (Wang CAT). Default is —-Taps. 


SEE ALSO 
cw(1), mm(1), mmt(1), nroff(1), tbi(1) 
eqnchar(5), mm(5), mv(5) in the Programmer’s Reference Manual 


RESTRICTIONS 


To embolden digits, parentheses, etc., it is necessary to quote them, as in bold 


ee 12.3" . 
See also RESTRICTIONS under troff(1). 


NOTE: Some printers or terminals may not be capable of performing all of the for- 


matting features of eqn(1). 
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NAME 
eucset - set or get EUC code set width 


SYNOPSIS 
eucset [cswidth] 
eucset -p 


DESCRIPTION 
The eucset command assumes the existence of an EUC line discipline (which 
does canonical processing of EUC characters) in its standard input Stream 
(usually a tty). The EUC line discipline must recognize the eucioc calls to 
ioctl(2), as defined in the header file sys/eucioctl.h. 


If given no arguments, eucset looks in the environment for the cswidth parameter 
in the character class table, which is assumed to specify the code set widths and 
screen widths in use. The format of cswidth parameter is described in character 
class table specification. 


If given one argument which does not begin with "_", it is taken to be a string in 
the format of cswidth parameter, overriding whatever is in the environment. 


If given the optional argument -p, eucset prints the current values of the code set 
widths and Screen widths as returned by the line discipline. These values may be 
different than what is currently in the user’s environment, but represents the 
EUC mapping that the EUC line discipline is currently using. Code set 0 
(ASCII) is excluded from the listing, which is in the same format as the cswidth 
parameter. 


RETURN VALUES 
The eucset command returns 0 on success, 1 on failure of any call to ioctl(2). 


FILES 
/usr/include/sys/eucioctl.h 
/usr/include/sys/euc.h 
/usr/include/sys/cswidth.h 


SEE ALSO 
ioctl(2), getwidth(3W), eld0(7), streamio(7) in the Programmer’s Reference 
Manual 
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NAME 
ex - text editor 


& SYNOPSIS 


ex[-i-s]{-+][-L][-R ][ + [fle]] [-t ag ][v][-x1]1[-C] 
[ +command | -c command | file ... 


DESCRIPTION 
The ex command is the root of a family of editors: ex and w. It is a superset of 
ed, with the most notable extension being a display editing facility. Display-based 
editing is the focus of wi. 


If you have a CRT terminal, you may wish to use a display-based editor. (See 
vi (1), which is a command that focuses on the display editing portion of ex.) If 
you have used ed, you will find that ex has a number of new features useful on 
CRT terminals. Intelligent terminals and high speed terminals work well with wi. 
Generally, the editor utilizes terminal capabilities more than ed does. It drives 
your terminal efficiently by determining your terminal type from the TERM 
environment variable and analyzing the terminal capability data base, terminfo(4). 
a The editor makes use of features such as insert and delete character and line in 
its visual command (which can be abbreviated vi) which is the central mode of 
editing when using vi (1). 


ex contains a number of features for easy viewing of the text of the file. The z 
command allows easy access to windows of text. Pressing < Ctrl > D causes 
the editor to scroll a half-window of text and is more useful for quickly stepping 
through a file than just pressing < cr >. Of course, the screen-oriented visual 
mode gives constant access to editing context. 


ex gives you more help when you make mistakes. The undo (u) command allows 
you to reverse any single change which goes astray. ex gives you a lot of 
feedback, normally printing changed lines, and indicates when more than a few 
lines are affected by a command so that it is easy to detect when a command has 
affected more lines than it should have. 


The editor also normally prevents overwriting existing files unless you edited 
them so that you do not accidentally overwrite with a write a file other than the 

on one you are editing. If the system (or editor) crashes, or you accidentally hang 
up the phone, you can use the editor recover command to retrieve your work. 
This gets you back to within a few lines of where you left off. 


ex has several features for dealing with more than one file at a time. You can 
give it a list of files on the command line and use the next (n) command to deal 
with each in turn. The next command can also be given a list of filenames, or a 
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pattern as used by the shell to specify a new set of files to be dealt with. In 
general, filenames in the editor may be formed with full shell metasyntax. The 
metacharacter % is also available in forming filenames and is replaced by the 
name of the current file. . 


For moving text between files, and within a file, the editor has a group of buffers, 
named a through z. You can place text in these named buffers and carry it over 
when you edit another file. 


The & command, in ex, repeats the last substitute command. In addition there is 
a confirmed substitute command. You give a range of substitutions to be done 
and the editor interactively asks whether each substitution is desired. 


It is possible to ignore the case of letters in searches and substitutions. ex also 
allows regular expressions which match words to be constructed. This is 
convenient, for example, in searching for the word "edit" if your document also 
contains the word "editor." 


ex has a set of options which you can tailor to your liking. One option, which is 
very useful, is the autoindent option which allows the editor to automatically 
supply leading white space to align text. You can then use the < Ctrl > d key 
as a backtab, space, and tab forward to align new code easily. 


Miscellaneous features include an intelligent join (j) command which supplies 
white space between joined lines automatically, the < and > commands which 
shift groups of lines, and the ability to filter portions of the buffer through 
commands such as sort. 


OPTIONS 
The following invocation options are interpreted by ex: 


- Or -s 
Suppress all interactive-user feedback. This is useful in processing editor 
scripts. 


-1 Set LISP mode; indenting appropriately for lisp code. The () { } [[ and 
] ] commands in wi are modified to have meaning for lisp. 


-L___ List the names of all files saved as a result of an editor or system crash. 


-R Set readonly mode preventing accidentally overwriting the file. 
-r file 


Recover file after an editor or system crash. If file is not specified, a list of 
all saved files is printed. 
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-t fag 
Edit the file containing the tag and position the editor at its definition. 


~~ -v_ Invoke w. 


-x Set encryption mode; a key is prompted for allowing creation or editing of 
an encrypted file [see crypt(1)]. This option is dependent on the encryption 
module being installed and linked on the system. Without the encryption 
module, text is unchanged. 


-C_ Encryption option; same as the -x option except that edit simulates the 
less-than-or-equal command of ex(1) and all text read in is assumed to have 
been encrypted. 


+ command | -c command 
Begin editing by executing the specified editor search or positioning 
command. 


file The file argument(s) indicate file(s) to be edited. 
EX STATES 


o™~ Command 
| Normal and initial state. Input prompted for by: (colon). Your kill 
character cancels partial command. 


Insert 
Entered by a,i and c. Arbitrary text may be entered. Insert is normally 
terminated by a line having only a (.) character on it, or abnormally with an 
interrupt. 


Visual 
Entered by vi, terminates with Q or ~\. 


EX COMMAND NAMES AND ABBREVIATIONS 


ab abbrev 
a append 
ar args 
c change 
co copy 
f~ d delete 
| 7 e edit 
f file 
g global 
i insert 
j join 
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map 
ma mark 
m move 
n next 
nu number 
pre preserve 
p print 
pu put 
q quit 
re read 
rec recover 
rew rewind 
se set 
sh shell 
so source 
st stop 
S substitute 
una unabbrev 
u undo 
unm unmap 
ve version 
vi visual 
Ww write 
X xit 
ya yank 
Z window | 
! escape 
< Ishift 
<cr> print next 
& resubst 
> rshift 


< Ctrl > D J scroll 


EX COMMAND ADDRESSES 


n line n 

. current 
$ last 

5 next 

- previous 


+n n forward 
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% 1,$ 

/pat next with pat 
fA ?pat previous with pat 

X-n n before x 

X,y x through y 

= marked with x 

"0 previous context 


INITIALIZING OPTIONS 


EXINIT place set’s here in environment var. 
$HOME/.exrc editor initialization file 

/.exre editor initialization file 

set x enable option 

set nox disable option 

set x=val give value val 

set show changed options 

set all show all options 

set x? show value of option x 


f \ MOST USEFUL OPTIONS 


autoindent al supply indent 
autowrite aw write before changing files 
ignorecase ic in scanning 
lisp () { } are s-exp’s 
list print “I for tab, $ at end 
magic . [ * special in patterns 
number nu number lines 
paragraphs para macro names which start ... 
redraw simulate smart terminal 
scroll command mode lines 
sections sect macro names ... 
shiftwidth SW for < >, andinput < Ctrl > D 
showmatch sm to ) and } as typed 
showmode smd show insert mode in wi 
slowopen slow stop updates during insert 
a window visual mode lines 
| wrapscan WS around end of buffer? 
wrapmargin wm automatic line splitting 


UP-13525.1 V1 Page 5 


EX(1) 


SCANNING PATTERN FORMATION 


beginning of line 
$ end of line 
; any character 
\< beginning of word 
\> end of word 
[str] any char in str 
[ T str] ... not in str 
[x-y] ... between x and y 
* 


any number of preceding 


Internationalization 
The ex command can process characters from supplementary code sets as well as 
ASCII characters. In regular expressions, searches and pattern matching are 
performed in character units, not in individual bytes. 


FILES 
/usr/lib/ex? .? strings error messages 
/usr/lib/ex? .?recover recover command 
/usr/lib/ex?.? preserve preserve command 
/usr/lib/*/* describes capabilities of terminals 
$SHOME/.exrc editor startup file 
{Ore editor startup file 
/tmp/Exnnnnn editor temporary 
/tmp/Rxnnnann named buffer temporary 
/usr/preserve preservation directory 
SEE ALSO 


awk(1), crypt(1), ed(1), edit(1), grep(1), sed(1), vi(1) 
curses(3X), term(4), terminfo(4) in the Programmer’s Reference Manaul 


WARNINGS AND RESTRICTIONS 
The undo command causes all marks to be lost on lines changed and then 
restored if the marked lines were changed. 


undo never clears the buffer modified condition. 


The z command prints a number of logical, rather than physical, lines. More 
than a screen full of output may result if long lines are present. 


File input/output errors do not print a name if the command line "=" option is 
used. 
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There is no easy way to do a single scan ignoring case. The editor does not warn 
if text is placed in named buffers and not used before exiting the editor. 


( | ) Null characters are discarded in input files and cannot appear in resultant files. 
The crypt feature is available only in the United States. 
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NAME 
mm expr - evaluate arguments as an expression 


SYNOPSIS 
expr arguments 


DESCRIPTION 
The arguments are taken as an expression. After evaluation, the result is written | 
on the standard output. Terms of the expression must be separated by blanks. 

Characters special to the shell must be escaped. Note that 0 is returned to 
indicate a zero value, rather than the null string. Strings containing blanks or 
other special characters should be quoted. Integer-valued arguments may be 
preceded by a unary minus sign. Internally, integers are treated as 32-bit, 2s 
complement numbers. 


The operators and keywords are listed below. Characters that need to be 
escaped are preceded by \. The list is in order of increasing precedence, with 
equal precedence operators grouped within { } symbols. 
o™ expr \{ expr 
returns the first expr if it is neither null nor 0, otherwise returns the 
second expr. 


expr \& expr 
returns the first expr if neither expr is null or 0, otherwise returns 0. 


expr { =,\>,\>=,\<,\<=,!= } expr 
returns the result of an integer comparison if both arguments are 
integers, otherwise returns the result of a lexical comparison. 


expr { wie } expr 
addition or subtraction of integer-valued arguments. 


expr { \*,/, % } expr 
multiplication, division, or remainder of the integer-valued arguments. 


expr : expr 
The matching operator : compares the first argument with the second 
argument which must be a regular expression. Regular expression syntax 

f~ is the same as that of ed(1), except that all patterns are "anchored" (i.e., 

begin with ~) and, therefore, ~ is not a special character, in that 
context. Normally, the matching operator returns the number of 
characters matched (0 on failure). Alternatively, the \(...\) pattern 
symbols can be used to return a portion of the first argument. 
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Internationalization 
expr can process characters from supplementary code sets in addition to ASCII 
characters. In regular expressions, pattern searches are performed on characters, a, 
not bytes. : returns the matched size in bytes, not characters. 


EXAMPLES 
1, a=’expr $a + 
adds 1 to the shell variable a. 


2. # ’For $a equal to either "/usr/abc/file" or just “file” 
expr Sa-2.’.*/\G"\)’ \j 32 
| returns the last segment of a pathname (i.e., file). Watch out for / 
alone as an argument: expr takes it as the division operator (see 
BUGS below). 


3. # A better representation of example 2. 


expr //$a :.’.*/\(.*\)’ 
The addition of the // characters eliminates any ambiguity about the 
division operator and simplifies the whole expression. 


4. expr $VAR: ’.® 


returns the number of characters in $VAR. ww 
SEE ALSO 
ed(1), sh(1) 
DIAGNOSTICS 
As a side effect of expression evaluation, expr returns the following exit values: 
0 if the expression is neither null nor 0 
1 if the expression is null or 0 
2 for invalid expressions. 
syntax error for operator/operand errors 


non-numeric argument _ if arithmetic is attempted on such a string 
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BUGS 


After argument processing by the shell, expr cannot tell the difference between an 
operator and an operand except by the value. If $a is an =, the command: 


expr $a 
looks like: 
expr = 


? > 


as the arguments are passed to expr (and they are all taken as the = operator). 


The following works: 


expr X$a 
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NAME 
exstr - extract strings from source files 


SYNOPSIS 
exstr files 
exstr -e files 
exstr -r [ -d ] file 


DESCRIPTION 
The exstr utility is used to extract strings from source files and replace them by 
calls to the message retrieval function; see gettxt(3X). In the first form, exstr finds 
all strings in the source files and writes them on the standard output. Each string 
is preceded by the source filename and a colon. 


-€ Produces on the standard output a list of strings from the named C source 
files with positional information. 


The following is the format of the output: 


file:line:position:msgfile:msgnum:string 


rn The following fields are created by exstr: 
file the name of the C source file 
line line number in the file 
position character position in the line 
string the extracted text string 


The application developer supplies the remaining two fields: 
msgfile the file that contains the created text strings 


A file with the same name must be created and installed in the appropriate place 
by the gencat(1) utility. 


msgnum the sequence number of the string in the message file 


This file must be examined by the developer to identify which strings can be 

translated and retrieved by the message retrieval function. The developer has to 

delete lines that cannot be translated and insert the names of message file(s) and 
a. message number(s) in their appropriate places. The names of message files must 
| be the same as the names of files created by gencat(1) and installed in 

ibflocale/ < locale > /LC_MESSAGES. The message numbers must correspond 

to the sequence numbers of strings in the message files. 
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-r Modify the C source file by replacing strings with function calls to the 
message retrieval function gettxt. 


The first step is to invoke exstr with the -e option to create a list of strings. This 
list is examined and modified by deleting lines and adding the message filenames 
and numbers to their appropriate places. The exstr command with the -r option 
uses the modified list of strings as the input C source file. Strings in the source 
file are replaced by a call to the message retrieval function getit(3X). The 
msgfile and msgnum fields are used to construct the first argument to gettrt. 
Without the -d option, the second argument to gettxt is the null string; see 
gettt(3X). 


-d This option is used together with the -r option. The extracted strings are 
used as second arguments to the retrieval function (geftxt). 


This utility would not be capable of performing strings replacement in all 
instances. For example, a static initialized character string cannot be replaced by 
a function call. Another example is a string which could be in a form of an 
escape sequence which would not be translated. These examples strongly suggest 
that, in order not to break existing code, the files created by invoking exstr with 
the -e option must be examined, and lines containing strings not replaceable by 
function calls must be deleted. In some cases, the code may require 
modifications so that strings can be extracted and replaced by calls to the 
message retrieval function. 


EXAMPLES 
The following examples show uses of exstr. 


The file foo.c contains two strings. 


main() 

{ 
printf("This is an example\n"); 
printf("Hello world! !\n"); 

} 


The exstr utility, invoked with the argument foo.c extracts strings from the named 
file and prints them on the standard output. exstr foo.c produces the following 
output: 


foo.c:This is an example\n 
foo.c:Hello world\n 
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exstr -e foo.c produces the following output: 


: foo.c:3:8:::This is an example\n 
) foo.c:4:8:::Hello world! \n 


The developer must supply the msgfile and msgnum fields before the strings can 
be replaced by calls to the retrieval function. If UX is the name of the message 
file and the numbers 7 and 2 represent the sequence number of the strings in the 
file, the following are the contents of strings file after this information has been 
added: 


foo.c:3:8:U X:1:This is an example\n 
foo.c:4:8:0 X:2:Hello world!\n 


The exstr utility can now be invoked with the -r option to replace the strings in 
the source file by calls to the message retrieval function (gettxt). 


exstr -r foo.c < strings > intlfoo.c 
The following is the output of the command: 


extern char *gettxt(): 


c™ main() 


{ 
printf (gettxt("UX:1","")); 
printf (gettxt("UX:2","")); 
} 


The exstr -rd foo.c < strings > intlfoo.c uses the extracted strings as a second 
argument to 2gettrt. 


extern char *gettxt(); 

main() 

{ 
printf(gettxt("UX:1","This is an example\n")); 
printf (gettxt("UX:2", "Hello world! !\n")); 


FILES 
/lib/locale/< locale >/LC_MESSAGES/* 
message file created by gencat(1) 


ae, 
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SEE ALSO 
gencat(1) 
setlocale(3C), gettxt(3X) in the Programmer’s Reference Manual 


DIAGNOSTICS 


The error messages produced by exstr are intended to be self-explanatory. They 
indicate errors in the command line or format errors encountered within the: 
strings file. 
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| NAME 
| _ factor - obtain the prime factors of a number 


SYNOPSIS 
factor [ integer ] 


DESCRIPTION 
When you use factor without an argument, it waits for you to give it an integer. 
After you give it a positive integer, it factors the integer, prints its prime factors 
| the proper number of times, and then waits for another integer. factor exits if it 
encounters a zero or any non-numeric character. 


If you invoke factor with an argument, it factors the integer as described above, 
and then it exits. 


The maximum time to factor an integer is proportional to sqrt(n). factor takes 
this time when 7 is prime or the square of a prime. 


— ek ce tt a3 


DIAGNOSTICS 
o™ factor prints the error message, "Ouch," for input out of range or for garbage 
input. 
f / 
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NAME 
r~ fgrep - search a file for a character string 


SYNOPSIS 
fgrep [options] string [file ...] 


DESCRIPTION 
The fgrep (fast grep) command seaches files for a character string and prints all 
lines that contain that string. fgrep is different from grep(1) and egrep(1) because 
it searches for a string, instead of searching for a pattern that matches an 
expression. It uses a fast and compact algorithm. 


The characters $, *, [, ~, |, ( ), and \ are interpreted literally by fgrep, that 1s, 
fgrep does not recognize full regular expressions as does egrep. Since these 
characters have special meaning to the shell, it is safest to enclose the entire 
string in single quotes ’...’. 


If no files are specified, fgrep assumes standard input. Normally, each line found 
is copied to the standard output. The filename is printed before each line found 


aa if there is more than one input file. 
| Command line options are: 

-b Precede each line by the block number on which it was found. This can 
be useful in locating block numbers by context (first block 1s 0). 

-C Print only a count of the lines that contain the pattern. 

-i Ignore uppercase/lowercase distinction during comparisons. 

- Print the names of files with matching lines once, separated by newlines. 
Does not repeat the names of files when the pattern is found more than 
once. 

-n Precede each line by its line number in the file (first line 1s 1). 

-V Print all lines except those that contain the pattern. 


“x Print only lines matched entirely. 
-e special_string 

Search for a special string (string begins with a -). 
-f file Take the list of strings from file. 


> Internationalization 
The command can process characters from supplementary code sets. 
grep Pp upp 
Searches are performed on characters, not on individual bytes. 
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Option: | 


-i_ §_ Ignore upper/lowercase distinction during comparisions; valid for single- 
byte characters only. ad 


SEE ALSO 
ed(1), egrep(1), grep(1), sed(1), sh(1) 


DIAGNOSTICS 
Exit status is 0 if any matches are found, 1 if none, 2 for syntax errors or 
inaccessible files (even if matches were found). 


BUGS 
Ideally there should be only one grep command, but there is not a single 
algorithm that spans a wide enough range of space-time tradeoffs. Lines are 
limited to BUFSIZ characters; longer lines are truncated. BUFSIZ is defined in 
/usr/include/stdio.h. 
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NAME 
file - determine file type 


SYNOPSIS 
file [ -c | [ -f ffile ] [ -m mfile ] arg ... 


DESCRIPTION 
The file command performs a series of tests on each argument in an attempt to 
classify it. If an argument appears to be ASCII, file examines the first 512 bytes 
and tries to guess its language. If an argument is an executable a.out, file prints 
the version stamp, provided it is greater than 0. 


-< The -c option causes file to check the magic file for format errors. This 
validation is not normally carried out for reasons of efficiency. No file 
typing is done under -c. 


-£ If the -f option is given, the next argument is taken to be a file containing 
the names of the files to be examined. 


-m The -m option instructs file to use an alternate magic file. 


file uses the file /etc/magic to identify files that have some sort of magic number, 
that is, any file containing a numeric or string constant that indicates its type. 
Commentary at the beginning of /etc/magic explains its format. 


Internationalization 
The file command can classify files containing characters from supplementary 
code sets. The file command reads each argument and can distinguish data files, 
program text files, shell scripts and executable files as follows: 


Files Classification 


Data files containing data 
supplementary characters 


Shell scripts containing command text 
supplementary characters 


Language program text files wor text 
containing literals or 

comments using supplementary 

characters 


Executable files executable 
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FILES 
/etc/magic 


SEE ALSO 
filehdr (4) in the Programmer’s Reference Manual 
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NAME 
find - find files 


SYNOPSIS 
find path-name-list expression 


DESCRIPTION 
The find command recursively descends the directory hierarchy for each 
pathname in the path-name-list (i.c., one or more pathnames) seeking files that 
match a Boolean expression written in the primaries given below. 


In the descriptions, the argument n is used as a decimal integer where +n means 
more than n, -n means less thann, andn means exactlyn. 


In the descriptions for atime, mtime and ctime, the current date is 0. 


-name file 
True if file matches the current filename. Normal shell argument syntax 
may be used if escaped (watch out for [, ?, and *). 
-perm onum 
True if the file permission flags exactly match the octal number onum [see 
chmod(1)]. If onum is prefixed by a minus sign, more flag bits [017777, see 
stat(2)] become significant and the flags are compared. 
-type e 
True if the type of the file is c, where c is b, c, d, p, or f for block special 
file, character special file, directory, fifo (pipe), or plain file respectively. 
-links n 
True if the file has 7 links. 
-user iname 
True if the file belongs to the user uname. If uname is numeric and does 
not appear as a login name in the /etc/passwd file, it is taken as a user ID. 
-group gname 
True if the file belongs to the group gname. If gname is numeric and does 
not appear in the /ete/group file, it is taken as a group ID. 
-size n[c] 
True if the file is n blocks long (512 bytes per block). Ifn is followed by a 
c, the size is in characters. 
-atime n 
True if the file has been accessed inn days. The access time of directories 
in path-name-list is changed by find itself. 
-mtime 71 
True if the file has been modified in n days. 


UP-13525.1 V1 Page 1 


FIND (1) 


-ctime 7 
True if the file has been changed inn days. 


-exec cmd _ 
True if the executed cmd returns a zero value as exit status. The end of Vs 
cmd must be punctuated by an escaped semicolon. A command argument 
{ } is replaced by the current pathname. 

-ok cmd 
Like -exec except that the generated command line is printed with a 
question mark first, and is executed only if the user responds by entering y. 

-print 
Always true; prints the current pathname. 

-cpio device 
True when the device specified by device can be opened and written to. 

This option writes the current file on device in cpio (4) format (5120 byte 
records). The current file is written out in cpio copy out mode (i.e. cpio -o 
with no options). 

-newer file 
True if the current file has been modified more recently than the argument 
file. ie. 

-depth 
Always true; causes descent of the directory hierarchy to be done so that all 
entries in a directory are acted on before the directory itself. This can be 
useful when find is used with cpio (1) to transfer files that are contained in 
directories without write permission. 

( expression ) 

True if the parenthesized expression is true (parentheses are special to the 
shell and must be escaped). 


The primaries may be combined using the following operators (in order of 
decreasing precedence): 


The negation of a primary (! is the unary not operator). 

Concatenation of primaries (the and operation is implied by the juxtaposition 
of two primaries). 

Alternation of primaries (-o is the or operator). 


EXIT CODES ‘, 
The ext status of find indicates normal or abnormal termination on the J 
command, not whether or not anything was found which satisfies expression. 
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EXAMPLES 
To remove all files in . (dot) named *.0 that have not been accessed for a week: 


find . -name **.o’ -atime +7 -exec rm {} \; 
To list all plain files that have not been modified for 31 days in the dir directory: 
find dir -type f -mtime +31 -exec Is -Id "{}" \; 
To find all files in the current directory which contain word: 
find . -type f -print|xargs grep -n word’ 
FILES 


/etc/passwd 
/etc/group 


SEE ALSO | 
chmod(1), cpio(1), sh(1), test(1) 
stat(2), cpio(4), fs(4) in the Programmer’s Reference Manual 


DIAGNOSTICS 
The message: Process table full is displayed if there is not enough room in the 
process table to create another process. 
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NAME 
a gdev: hpd, erase, hardcopy, tekset, td - graphical device routines and filters 


SYNOPSIS 
hpd [-options] [GPS file ...] 
erase 
hardcopy 
tekset 
td [-ernn] [GPS file ...] 


DESCRIPTION 
All of the commands described below reside in /usr/bin/graf [see graphics(1G)]. 


hpd hpd translates a GPS [graphical primitive string; see gps(4)] to 
instructions for the Hewlett-Packard 7221A Graphics Plotter. A 
viewing window is computed from the maximum and minimum points 
in file unless the -u or -r option is provided. If no file is given, the 
standard input is assumed. options are: 


“™ cn Select character set n,n between 0 and 5 (see the HP7221A 
) Plotter Operating and Programming Manual, Appendix A). 


px Select pen numbered z, 7 between 1 and 4 inclusive. 

m Window on GPS region an, n between 1 and 25 inclusive. 
sn Slant characters n degrees clockwise from the vertical. 

u_—SC Window on the entire GPS universe. 


xdn Set x displacement of the viewport’s lower left corner ton 
inches. 


xvn Set width of viewport ton inches. 


ydn Set y displacement of the viewport’s lower left corner ton 
inches. 


yvn Set height of viewport to n inches. 


erase erase sends characters to a Tektronix 4010 series storage terminal to 
: ) erase the screen. 


hardcopy When issued at a Tektronix display terminal with a hard copy unit, 
hardcopy generates a screen copy on the unit. 
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tekset tekset sends characters to a Tektronix terminal to clear the display 
screen, set the display mode to alpha, and set characters to the 


smallest font. 


td td translates a GPS to scope code for a Tektronix 4010 series storage 
terminal. A viewing window is computed from the maximum and 
minimum points in file unless the -u or -r option is provided. If no 
file is given, the standard input is assumed. Options are: 


e Do not erase screen before initiating display. 
m Display GPS region n, n between 1 and 25 inclusive. 
u_— Display the entire GPS universe. 

SEE ALSO 


ged(1G), graphics(1G) 
gps(4) in the Programmer’s Reference Manual 
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NAME 
en ged - graphical editor 


SYNOPSIS 
ged [-eruR]n] [GPS file ...] 


DESCRIPTION 
The ged program is an interactive graphical editor used to display, construct, and 
edit GPS files on Tektronix 4010 series display terminals. If GPS file(s) are 
given, ged reads them into an internal display buffer and displays the buffer. The 
GPS in the buffer can then be edited. If - is given as a filename, ged reads a GPS 
from the standard input. 


ged accepts the following command line options: 
e Do not erase the screen before the initial display. 
m _ Display region number n. 
u _—ODisplay the entire GPS universe. 
c™ R____ Restricted shell invoked on use of !. 


A GPS file is composed of instances of three graphical objects: dines, arc, and 
text. Arc and lines objects have a start point, or object-handle, followed by zero or 
more points, or point-handles. Text has only an object-handle. The objects are 
positioned within a Cartesian plane, or universe, having 64K (-32K to +32K) 
points, or universe-units, on each axis. The universe is divided into 25 equal sized 
areas called regions. Regions are arranged in five rows of five squares each, 
numbered 1 to 25 from the lower left of the universe to the upper right. 


ged maps rectangular areas, called windows, from the universe onto the display 
screen. Windows allow the user to view pictures from different locations and at 
different magnifications. The universe-window is the window with minimum 
magnification, i.e., the window that views the entire universe. The home-window 
is the window that completely displays the contents of the display buffer. 


COMMANDS 
ged commands are entered in stages. Typically each stage ends with a <cr> 
rr, (return). Prior to the final <cr> the command may be aborted by typing 


rubout. The input of a stage may be edited during the stage using the erase and 
kill characters of the calling shell. The prompt * indicates that ged is waiting at 
stage 1. 


UP-13525 V1 R1 Page 1 


GED(1G) 


Each command consists of a subset of the following stages: 


1. Command line 
A command line consists of a command name followed by WwW 
argument(s) followed by a <er>. A command name is a single 
character. Command arguments are either option(s) or a file-name. 
Options are indicated by a leading -. 


2. Text Text is a sequence of characters terminated by an unescaped 
<cr> (120 lines of text maximum). 


3. Points Points is a sequence of one or more screen locations (maximum of 
30) indicated either by the terminal crosshairs or by name. The 
prompt for entering points is the appearance of the crosshairs. 
When the crosshairs are visible, typing: 


sp __ (space) enters the current location as a point. The point is 
identified with a number. 


$2: enters the previous point numbered n. 


$x enters the point labeled x. 


establishes the previous points as the current points. At the 
start of a command the previous points are those locations 
given with the previous command. 


>x labels the last point entered with the uppercase letter x. | | 


= echoes the current points. 


$.2 enters the point numbered n from the previous points. 
# erases the last point entered. 
@ _ erases all of the points entered. 


4. Pivot The pivot is a single location, entered by typing <cr> or by using 
the $ operator, and indicated with a *. 


5. Destination 
The destination is a single location entered by typing <cr> or by 


using $. Ls 


COMMAND SUMMARY 
In the summary, characters typed by the user are printed in bold. Command 
stages are printed in italics. Arguments surrounded by brackets "[]" are optional. 
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Parentheses "()" surrounding arguments separated by "or" means that exactly one 


o™ of the arguments must be given. 
Construct commands: 

Arc [-echo,style,weight] points 

Box [-echo,style,weight] points 

Circle [-echo,style,weight] points 

Hardware __[-echo] text points 

Lines [-echo,style,weight] points 

Text [-angle,echo,height,mid-point,right-point,text,weight] text 

points 


Edit commands: 


Delete ( - (universe or view) or points ) 
f~ Edit (-angle,echo,height,style,weight] ( - (universe or view) or 
points ) 
Kopy [-echo, points,x] points pivot destination 
Move [-echo, points,x] points pivot destination 
Rotate [-angle,echo,kopy,x] points pivot destination 
Scale [-echo,factor,kopy,x] points pivot destination 


View commands: 


coordinates points 
erase 
new-display 
object-handles _——_(_- (universe or view) or points ) 
| ios \ point-handles ( - (labelled-points or universe or view) or points ) 
view ( - (home or universe or region) or [-x] pivot 


destination ) 


x [-view] points 


GED(1G) 


zoom 
Other commands: 
quit or Quit 
read 
set 
write 
!command 


? 


Options: 


[-out] points 


[-angle,echo, height,mid-point,right-point,text,weight 
file-name [destination] 


[-angle,echo, factor, height, kopy,mid-point, points, 
right-point,style,text,weight,x] 


file-name 


Options specify parameters used to construct, edit, and view graphical objects. If 
a parameter used by a command is not specifed as an option, the default value 
for the parameter is used (see set The format of command options is: 

-option [,option | 
where option is keyletter{value]. Flags take on the values of true or false indicated 
by + and - respectively. If no value is given with a flag, true is assumed. 


Object options: 
anglen 
echo 
factorn 


heightn 


kopy 
mid-point 
points 
right-point 
styletype 
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Angle of n degrees. 
When true, echo additions to the display buffer. 
Scale factor is m percent. 


The height of fext is given inn universe-units (0 < = 
n < 1280). 


When true, copy rather than move. 

When true, mid-point is used to locate text string. 

When true, operate on points; otherwise operate on objects. 
When true, right-point is used to locate text string. 


Line style set to one of following types: 
sO solid 
da _—_ dashed 
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dd dot-dashed 


do dotted 
Id long-dashed 
text When false, text strings are outlined rather than drawn. 
weighttype Sets line weight to one of following types: 
n narrow 
m medium 
b bold 
Area options: 
home Reference the home-window. 
out Reduce. magnification. 
region Reference region n. 
universe Reference the universe-window. 
view Reference those objects currently in view. 
x Indicate the center of the referenced area. 


COMMAND DESCRIPTIONS 
Construct commands: 
Arc and Lines 

behave similarly. Each consists of a command line followed by points. The 
first point entered is the object-handle. Successive points are point- 
handles. Lines connect the handles in numerical order. Arc fits a curve to 
the handles (currently a maximum of 3 points is fit with a circular arc; 
splines will be added in a later version). 


Box and Circle 
are special cases of Lines and Arc, respectively. Box generates a rectangle 
with sides parallel to the universe axes. A diagonal of the rectangle would 
connect the first point entered with the last point. The first point is the 
object-handle. Point-handles are created at each of the vertices. Circle 
generates a circular arc centered about the point numbered zero and 
passing through the last point. The circle’s object-handle coincides with the 
last point. A point-handle is generated 180 degrees around the circle from 
the object-handle. 
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Text and Hardware | 
generate fext objects. Each consists of a command line, text and points. . 
Text is a sequence of characters delimited by <cr>. Multiple lines of text a 
may be entered by preceding a cr with a backslash (i.e., \cr). The Text 
command creates software-generated characters. Each line of software text 
is treated as a separate text object. The first point entered is the object- 
handle for the first line of text. The Hardware command sends the 
characters in fext uninterpreted to the terminal. 


Edit commands: 

Edit commands operate on portions of the display buffer called defined areas. A 
defined area is referenced either with an area option or interactively. If an area 
option is not given, the perimeter of the defined area is indicated by points. If no 
point is entered, a small defined area is built around the location of the <cr>. 
This is useful to reference a single point. If only one point is entered, the 
location of the <cr> is taken in conjunction with the point to indicate a diagonal 
of a rectangle. A defined area referenced by points is outlined with dotted lines. 


Delete i | 
removes all objects whose object-handle lies within a defined area. The 
universe option removes all objects and erases the screen. 


Edit modifies the parameters of the objects within a defined area. Parameters 
that can be edited are: 
angle angle of fext 
height height of text 
style style of lines and arc 
weight weight of lines, arc, and text. 


Kopy (or Move) 
copies (or moves) object- and/or point-handles within a defined area by the 
displacement from the pivot to the destination. 


Rotate 
rotates objects within a defined area around the pivot. If the kopy flag is 
true then the objects are copied rather than moved. 

Scale ‘ | 
For objects whose object handles are within a defined area, point Nad 
displacements from the pivot are scaled by factor percent. If the kopy flag 
is true then the objects are copied rather than moved. 
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View commands: 


coordinates 
ile | prints the location of point(s) in universe- and screen-units. 
erase clears the screen (but not the display buffer). 


new-display 
erases the screen then displays the display buffer. 


object-handles (or point-handles) 
labels object-handles (and/or point-handles) that lie within the defined area 
with O (or P). Point-handles identifies labeled points when the labelled- 
points flag is true. 


view moves the window so that the universe point corresponding to the pivot 
coincides with the screen point corresponding to the destination. Options 
for home, universe, and region display particular windows in the universe. 


x indicates the center of a defined area. Option view indicates the center of 
the screen. 


f \ zoom 


decreases (zoom out) or increases the magnification of the viewing window 
based on the defined area. For increased magnification, the window is set 
to circumscribe the defined area. For a decrease in magnification the 
current window is inscribed within the defined area. 


Other commands: 
quit or Quit 
exit from ged. Quit responds with ? if the display buffer has not been 
written since the last modification. 


read inputs the contents of a file. If the file contains a GPS it is read directly. If 
| the file contains text it is converted into text object(s). The first line of a 
| text file begins at destination. 


set when given option(s) resets default parameters, otherwise it prints current 


default values. 
tiie write outputs the contents of the display buffer to a file. 
: escapes ged to execute a UNIX system command. 


2 lists ged commands. 
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SEE ALSO 
gdev(1G), graphics(1G), sh(1) 
gps(4) in the Programmer’s Reference Manual 
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NAME 
“™ getopt - parse command options 


SYNOPSIS 
set -- ’getopt optstring $*° 


DESCRIPTION 
WARNING: Start using the new command gefopts (1) in place of getopt (1). 
getopt(1) will not be supported in the next major release. For more information, 
see the WARNINGS section, below. 


getopt is used to break up options in command lines for easy parsing by shell 
procedures and to check for legal options. optstring is a string of recognized 
option letters [see getopt(3C)]; if a letter is followed by a colon, the option is 
expected to have an argument which may or may not be separated from it by 
white space. The special option -- is used to delimit the end of the options. If it 
is used explicitly, getopt recognizes it; otherwise, getopt generates it; in either 
case, getopt places it at the end of the options. The positional parameters ($1 $2 
...) of the shell are reset so that each option is preceded by a - and is in its own 

f~, positional parameter; each option argument is also parsed into its own positional 
parameter. 


EXAMPLES 
The following code fragment shows how one might process the arguments for.a 
command that can take the options a or b, as well as the option o, which requires 


an argument: 

set -- ’getopt abo: $*’ 

if [$2 != 0] 

then 
echo $USAGE 
exit 2 

fi 

for i in $* 

do 
case $i in 

| ity -a | -b) FLAG = $i; shift;; 
-0) OARG = $2; shift 2;; 

--) shift; break;; 
esac 

done 
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This code accepts any of the following as equivalent: 


cmd -aoarg file file \ 
cmd -a -o arg file file WwW 
cmd -oarg -a file file 

cmd -a -oarg -- file file 


SEE ALSO 
getopts(1), sh(1) 
getopt(3C) in the Programmer’s Reference Manual 


DIAGNOSTICS 
getopt prints an error message on the standard error when it encounters an 
option letter not included in optstnng. 


WARNINGS 
getopt(1) does not support the part of Rule 8 of the command syntax standard 
[see intro(1)] that permits groups of option-arguments following an option to be 
separated by white space and quoted. For example, 


cmd -a -b -0 "xxx z yy" file \ ] 
is not handled correctly). To correct this deficiency, use the new command 
getopts (1) in place of getopt (1). 
getopt(1) will not be supported in the next major release. For this release a 
conversion tool has been provided, getoptcvt. For more information about getopts 
and getoptcvt, see the getopts (1) manual page. 


If an option that takes an option-argument is followed by a value that is the same 
as one of the options listed in optstring (referring to the earlier EXAMPLE 
section, but using the following command line: cmd -o -a file), getopt always 
treats -a as an option-argument to -o; it never recognizes -a as an option. For 
this case, the for loop in the example shifts past the file argument. 
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NAME 
getopts, getoptcvt - parse command options 


SYNOPSIS 
getopts optstring name [arg ...] 


/usr/lib/getoptcvt [-b] file 


DESCRIPTION | 
The getopts command is used by shell procedures to parse positional parameters 
and to check for legal options. It supports all applicable rules of the command 
syntax standard [see Rules 3-10, intro(1)]. It should be used in place of the 
getopt(1) command. (See the WARNING, below.) 


optstring must contain the option letters the command using gefopts recognizes; if 
a letter is followed by a colon, the option is expected to have an argument, or 
group of arguments, which must be separated from it by white space. 


Each time it is invoked, getopts places the next option in the shell variable name 
and the index of the next argument to be processed in the shell variable 
OPTIND. Whenever the shell or a shell procedure is invoked, OPTIND 1s 
initialized to 1. 

When an option requires an option-argument, getopts places it in the shell 
variable OPTARG. 


If an illegal option is encountered, ? is placed in name. 


When the end of options is encountered, getopts exits with a non-zero exit status. 
The special option "--" may be used to delimit the end of the options. 


By default, getopts parses the positional parameters. If extra arguments (arg ...) 
are given on the getopts command line, getopts parses them instead. 


/usr/lib/getoptcvt reads the shell script in file, converts it to use gefopts (1) instead 
of getopt (1), and writes the results on the standard output. 


-b __ the results of running /usr/lib/getoptcvt are portable to earlier releases of the 
UNIX system. /usr/lib/getoptcvt modifies the shell script in file so that when 
the resulting shell script is executed, it determines at run time whether to 
invoke getopts(1) or getopt(1). 


So all new commands adhere to the command syntax standard described in 
intro (1), they should use getopts (1) or getopt (3C) to parse positional parameters 
and check for options that are legal for that command (see WARNINGS, below). 
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EXAMPLES 
The following fragment of a shell program shows how one might process the 
arguments for a command that can take the options a or b, as well as the option 
0, which requires an option-argument: 


while getopts abo: c 


do 
case $c in 
a | b) FLAG = $c;; 
0) OARG = $OPTARG;; 
\?) echo $USAGE 
exit 2;; 
esac 
done 


shift ’expr $OPTIND - 1’ 
This code accepts any of the following as equivalent: 


cmd -a -b -o "xxx z yy" file 
cmd -a -b -o "xxx z yy" -- file 
cmd -ab -o xxxz,yy file 

cmd -ab -o "xxx z yy" file 
cmd -o xx,zyy -b -a file 


SEE ALSO 
intro(1), sh(1) 
getopts(3C) in the Programmer’s Reference Manual 


WARNINGS 
Although the following command syntax rule [see intro(1)] relaxations are 
permitted under the current implementation, they should not be used because 
they may not be supported in future releases of the system. As in the EXAMPLE 
section above, a and b are options, and the option o requires an option- 
argument: 
cmd -aboxxx file 

(Rule 5 violation: options with option- 

arguments must not be grouped with other 

options) 
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cmd -ab -oxxx file 
(Rule 6 violation: there must be white 
space after an option that takes an option- 
argument) 


Changing the value of the shell variable OPTIND or parsing different sets of 
arguments may lead to unexpected results. 


DIAGNOSTICS 
getopts prints an error message on the standard error when it encounters an 
option letter not included in optsting. 
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NAME 
gettxt - retrieve a text string from a message data base 


SYNOPSIS 
gettxt msgfile:msgnum [ dflt_msgCW ] 


DESCRIPTION 
The gettxt command retrieves a text string from a message file in the directory 
Nib/locale/locale/LC_MESSAGES. The directory locale corresponds to the 
language in which the text strings are written; see setlocale(3C). 


msgfile | Name of the file in the directory /libfocale/locale/LC_MESSAGES to 
retrieve msgnum from. The msgfile can be up to 14 characters in 
length, but may not contain either \0 (null) or the ASCII code for 
/ (slash) or : (colon). 


msgnum Sequence number of the string to retrieve from msgfile. The strings in 
msgfile are numbered sequentially from J ton where n is the number 
of strings in the file. 


dflt msg Default string to be used on failure to retrieve the message from the 
file. 


The text string to be retrieved is in the file created by the gencat(1) utility and 
installed in the Jocal directory in /lib/locale//ocale/LC_MESSAGE. The user 
controls which directory is searched by setting the environment variable 

LC_ MESSAGES. If LC_MESSAGES is not set, the environment variable LANG 
will be used. If LANG is not set, the language in which the strings are retrieved 
is U.S. English and the files containing the strings are in 
/lib/locale/C/LC_MESSAGES/* . 


If gettxt fails to retrieve a message in the requested language, it will try to retrieve 
the same message in U.S. English. If this also fails, the processing depends on 
the second argument. If the second argument is not supplied on the command 
line or it is the null string gettxt will display the string Message not found! ! in 
U.S. English. The second argument will be displayed if it is not the null string. 


Nongraphic characters can be included in the default message as alphabetic 
escape sequences. 


EXAMPLES 
gettxt UX:1 
gettxt UX:1 "hello world" 
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FILES 
/lib/locale/C/LC_MESSAGES/* U.S. English files created by gencat(1) 
/lib/locale/locale/[LC_MESSAGES/* message files for different languages 
created by gencat(1) 


SEE ALSO 
exstr(1) gencat(1) 
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NAME 
glossary - definitions of common UNIX system terms and symbols 


SYNOPSIS 
[ help | glossary [ term ] 


DESCRIPTION 
The UNIX system Help Facility command glossary provides definitions of 
common technical terms and symbols. 


Without an argument, glossary displays a menu screen listing the terms and 
symbols that are currently included in glossary. A user may choose one of the 
terms or may exit to the shell by typing q (for "quit"). When a term is selected, 
its definition is retrieved and displayed. By selecting the appropriate menu 
choice, the list of terms and symbols can be redisplayed. 


A term’s definition may also be requested directly from shell level (as shown 
above), causing a definition to be retrieved and the list of terms and symbols not 
to be displayed. Some of the symbols must be escaped if requested at shell level 
in order for the facility to understand the symbol. The following is a table which 
list the symbols and their escape sequence. 


SYMBOL ESCAPE SEQUENCE 


ney ey 
” ey 
0 \\A\I 
‘6 vy 
# \# 
& \& 
\ \\\\ 


From any screen in the Help Facility, a user may execute a command wia the 
shell [sh (1)] by typing a ! and the command to be executed. The screen is 
redrawn if the command that was executed was entered at a first level prompt. If 
entered at any other prompt level, only the prompt is redrawn. 


By default, the Help Facility scrolls the data that is presented to the user. If you 
prefer to have the screen clear before printing the data (non-scrolling), the shell 
variable SCROLL must be set to no and exported so it becomes part of your 
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environment. This is done by adding the following line to your .profile file [see 
profile (4)]: "export SCROLL ; SCROLL=no". If you later decide that scrolling is ; 
desired, SCROLL must be set to yes. 


Information on each of the Help Facility commands (starter, locate, usage, 
glossary, and help) is located on their respective manual pages. 


SEE ALSO 
help(1), helpadm(1M), locate(1), sh(1), starter(1), usage(1) 
term(5) in the Programmer’s Reference Manual 


WARNINGS 
If the shell variable TERM [see sh (1)] is not set in the user’s .profile file, then 
TERM defaults to the terminal value type 450 (a hard-copy terminal). For a list 
of valid terminal types, refer to term(5). 
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graph - draw a graph 


SYNOPSIS 


graph [ options ] 


DESCRIPTION 
The graph command with no options takes pairs of numbers from the standard 
input as abscissas and ordinates of a graph. Successive points are connected by 
straight lines. The graph is encoded on the standard output for display by the 
tplot(1G) filters. 


If the coordinates of a point are followed by a non-numeric string, that string is 
printed as a label beginning on the point. Labels may be surrounded with quotes 
", in which case they may be empty or contain blanks and numbers; labels never 
contain newlines. 


The following options are recognized, each as a separate argument: 


-a 
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Supply abscissas automatically (they are missing from the input); 
spacing is given by the next argument (default 1). A second optional 
argument is the starting point for automatic abscissas (default 0 or 
lower limit given by -x). 

Break (disconnect) the graph after each label in the input. 

Character string given by next argument is default label for each 
point. 

Next argument is grid style, 0 no grid, 1 frame with ticks, 2 full grid 
(default). 

Next argument is label for graph. 

Next argument is mode (style) of connecting lines: 0 disconnected, 1 
connected (default). Some devices give distinguishable line styles for 
other small integers (e.g., the Tektronix 4014: 2= dotted, 3 = dash-dot, 
4=short-dash, 5 =long-dash). 

Save screen, do not erase before plotting. 

If l is present, x axis is logarithmic. Next 1 (or 2) arguments are 
lower (and upper) x limits. Third argument, if present, is grid 
spacing on x axis. Normally these quantities are determined 
automatically. 

Similarly for y. 

Next argument is fraction of space for height. 

Similarly for width. 

Next argument is fraction of space to move right before plotting. 
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-u Similarly to move up before plotting. 
-t Transpose horizontal and vertical axes. (Option -x now applies to the 
vertical axis.) 


A legend indicating grid range is produced with a grid unless the -s option is 
present. If a specified lower limit exceeds the upper limit, the axis is reversed. 


SEE ALSO 
graphics(1G), spline(1G), tplot(1G) 


BUGS 
graph stores all points internally and drops those for which there is no room. 
Segments that run out of bounds are dropped, not windowed. 
Logarithmic axes may not be reversed. 
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NAME 
graphics - access graphical and numerical commands 


SYNOPSIS 
graphics [ -r ] 


DESCRIPTION 
The graphics command prefixes the pathname /usr/bin/graf to the current $PATH 
value, changes the primary shell prompt to ~, and executes a new shell. The 
directory /usr/bin/graf contains all of the Graphics subsystem commands. If the 
-r option is given, access to the graphical commands is created in a restricted 
environment; that is, $PATH 1s set to 

/usr/bin/graf:/rbin:/usr/rbin 

and the restricted shell, rsh, is invoked. To restore the environment that existed 
prior to issuing the graphics command, type EOT (control-d on most terminals). 
To logoff from the graphics environment, type quit. 


The command line format for a command in graphics is command name followed 
by argument(s). An argument may be a filename or an option string. A filename 
is the name of any UNIX system file except those beginning with -. The filename 
- is the name for the standard input. An option string consists of - followed by 
one or more option(s). An option consists of a keyletter possibly followed by a 
value. Options may be separated by commas. 


The graphical commands have been partitioned into four groups. 


Commands that manipulate and plot numerical data; see stat(1G). 

Commands that generate tables of contents; see toc(1G). | 
Commands that interact with graphical devices; see gdev(1G) and ged(1G). | 
A collection of graphical utility commands; see guti/(1G). 


A list of the graphics commands can be generated by typing whatis in the 
graphics environment. 


SEE ALSO | 
gdev(1G), ged(1G), gutil(1G), stat(1G), toc(1G) | 
gps(4) in the Programmer’s Reference Manual | 
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NAME 
r greek - select terminal filter 


SYNOPSIS 
greek [ -Tterminal | 


DESCRIPTION 
The greek filter reinterprets the extended character set, as well as the reverse and 
half-line motions, of a 128-character Teletype Model 37 terminal for certain other 
terminals. Special characters are simulated by overstriking, if necessary and 
possible. If the argument is omitted, greek attempts to use the environment 
variable $TERM [see environ(5)]. Currently, the following terminals are 


recognized: 
300 DASI 300. 
300-12 DASI 300 in 12-pitch. 
300s DASI 300s. 
300s-12. DASI 300s in 12-pitch. 
450 DASI 450. 

rf 450-12 DASI 450 in 12-pitch. 
1620 Diablo 1620 (alias DASI 450). 
1620-12 Diablo 1620 (alias DASI 450) in 12-pitch. 
2621 Hewlett-Packard 2621, 2640, and 2645. 
2640 Hewlett-Packard 2621, 2640, and 2645. 
2645 Hewlett-Packard 2621, 2640, and 2645. 
4014 Tektronix 4014. 
hp Hewlett-Packard 2621, 2640, and 2645. 
tek Tektronix 4014. 
FILES 

/usr/bin/300 

/usr/bin/300s 

/usr/bin/4014 

/usr/bin/450 

/usr/bin/hp 


SEE ALSO 

| 300(1), 4014(1), 450(1), hp(1), tplot(1G) 
eqn(1), mm(1), nroff(1) in the DOCUMENTER’S WORKBENCH reference 
manuals 
environ(S), greek(5), term(5) in the Programmer’s Reference Manual 
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NAME 
grep - search a file for a pattern 


SYNOPSIS 
grep [options] limited regular expression [file ...] 


DESCRIPTION 
The grep command searches files for a pattern and prints all lines that contain 
that pattern. grep uses limited regular expressions (expressions that have string 
values that use a subset of the possible alphanumeric and special characters) like 
those used with ed (1) to match the patterns. It uses a compact non- 
deterministic algorithm. 


Be careful using the characters $, *, [, ~, |, ( ), and \ in the Amited regular 
expression because they are also meaningful to the shell. It is safest to enclose 


3 


the entire limited regular expression in single quotes ’...’. 


If no files are specified, grep assumes standard input. Normally, each line found 
is copied to standard output. The filename is printed before each line found if 


there is more than one input file. 
| Command line options are: 

-b Precede each line by the block number on which it was found. This can 
be useful in locating block numbers by context (first block is 0). 

-C Print only a count of the lines that contain the pattern. 

“i Ignore uppercase/lowercase distinction during comparisons. 

-] Print the names of files with matching lines once, separated by newlines. 
Does not repeat the names of files when the pattern is found more than 
once. 

-n Precede each line by its line number in the file (first line is 1). 

-S Suppress error messages about nonexistent or unreadable files 

-V Print all lines except those that contain the pattern. 

Internationalization 


The grep command can process characters from supplementary code sets, as well 
as ASCII characters. Searches are performed on characters, not individual bytes. 


~~ Option: 


-i_ _ Ignores upper/lowercase distinction during comparisions; valid for single- 
byte characters only. 
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SEE ALSO 
ed(1), egrep(1), ferep(1), sed(1), sh(1) 


DIAGNOSTICS 
Exit status is 0 if any matches are found, 1 if none, 2 for syntax errors or 
inaccessible files (even if matches were found). 


BUGS 
Lines are limited to BUFSIZ characters; longer lines are truncated. BUFSIZ is 
defined in /usr/include/stdio.h. 


If there is a line with embedded nulls, grep only matches up to the first null; if it 
matches, it prints the entire line. 
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NAME 
gsar - graphical system activity reporter 


SYNOPSIS 
gsar [-Ss] [t{n]] 


DESCRIPTION 
The gsar function samples cumulative activity counters in the operating system 
and displays the resulting data graphically on Unisys supported terminals. The 
display mode is 132 columns. The data is presented dynamically on three logical 
screens (A, B, and C) as bar graphs with moving average indicators (vertical 
scaled lines) to the right of the bar graphs. 


To select a logical screen, simply type ’a’, ’b’, or ’c’. To toggle between screens, 
sumply press the escape key. 


gsar samples for n intervals of t seconds. The default value of t is 1. The default 
value of 7 is 100. 


gsar displays on the logical screen selected by the -§ option. The default for s is 
logical screen 0. | 


OPTIONS 
-Ss_ Select logical screen, where s is: 


0 logical screen A 
1 logical screen B 
y logical screen C 


LOGICAL SCREENS 
All screens display certain data with column headers matching display columns as 


follows: 
CPU utilization 
usr Portion of time running in user mode. 
sys Portion of time running in system mode. 
wio — Portion of time idle with some process waiting for block I/O. 
idle Portion of time otherwise idle. 
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Tables 
pre 
Ino 


fil 


Portion of process table filled. 
Portion of inode table filled. 
Portion of file table filled. 


All tables are displayed on a percent basis and will display "OV!" at the top of 
the column if an overflow has been detected. 


Memory 
mem 
Cache 
rch 


wch 


oul 
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Portion of user memory being used. 


Percent of read cache match/system buffers. 
Percent of write cache match/system buffers. 
Number of system calls per second. 

Number of read calls per second. 

Number of write calls per second. 

Number of forks per second. 

Number of execs per second. 

Number of characters read per second. 
Number of characters written per second. 


Number of times the kernel function iget was called per second. 


Number of times the kernel function namei was called per second. 


Number of times the kernel function dirblk was called per second. 


Average run queue length while occupied. 
Average swap queue length while occupied. 
Number of process switches per second. 
Input character rate. 

Input character rate processed by canon. 


Output character rate. 
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rcv Receive interrupt rates. 
xt Transmit interrupt rates. 


mdm Modem interrupt rates. 


EXAMPLES 
To view system activity for ten minutes, with samples every 5 seconds and the 
data presented on logical screen C: 


gsar -S2 5 120 


To view system activity for 100 seconds, with samples every second and the data 
presented on logical screen A (default situation): 


gsar 
or: 

sar -SO 1 100 
or: 

gsar 1 100 


FILES 
/usr/bin/gsar 
/usr/lib/sa/gsadc 


SEE ALSO 
sar(1) 


RESTRICTIONS 
This package supports only Unisys terminals. 


Occasionally, a terminal may get stuck in the middle of painting a box. If this 
happens, use ~ Q (control-Q) to free it. 
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NAME 
gutil - graphical utilities 


SYNOPSIS 
command-name [options] [files] 


DESCRIPTION 
Below is a list of miscellaneous device independent utility commands found in 
/usr/bin/graf. If no files are given, input is from the standard input. All output is 
to the standard output. Graphical data is stored in GPS format; see gps(4). 


bel - send bel character to terminal 


cvrtopt [ =sstring fstring istring tstring | [args | - options converter 
cvrtopt reformats args (usually the command line arguments of a 
calling shell procedure) to facilitate processing by shell procedures. 
An arg is either a filename (a string not beginning with a -, or a - by 
itself) or an option string (a string of options beginning with a -). 
on Output is of the form: 
-option -option . . . filename(s) 
All options appear singularly and preceding any filenames. Options 
that take values (e.g., -r1.1) or are two letters long must be described 
through options to cvrtopt. 


cvrtopt is usually used with set in the following manner as the first line 
of a shell procedure: 

set - cvrtopt = [options] $@ 
Options to cvrtopt are: 


sstring String accepts string values. 


fstring String accepts floating point numbers as values. 
istring String accepts integers as values. 
| tstring String is a two-letter option name that takes no value. 


String is a one- or two-letter option name. 


| | gd [GPS files | - GPS dump 
, gd prints a human readable listing of GPS. 
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gtop 


whatis 


yoo 


SEE ALSO 


[-rnu ] [GPS files ] - GPS to plot(4) filter 

gtop transforms a GPS into plot(4) commands displayable by plot 
filters. GPS objects are translated if they fall within the window that 
circumscribes the first file unless an option is given. 

Options: 


m translate objects in GPS region n. 
u translate all objects in the GPS universe. 


[ plot(5) files ] - plot(4) dump 
pd prints a human readable listing of plot(4) format graphical 
commands. 


[ plot(5) files } - plot(4) to GPS filter 
ptog transforms plot(4) commands into a GPS. 


- terminate session 


[ files | - remove comments 
remcom copies its input to its output with comments removed. 
Comments are as defined in C (i.e., /* comment */). 


[-o ] [ names ] - brief on-line documentation 

whatis prints a brief description of each name given. If no name is 
given, then the current list of description names is printed. The 
command whatis \* prints out every description. 

Option: 


0 just print command options 


file - pipe fitting 

yoo is a piping primitive that deposits the output of a pipeline into a 
file used in the pipeline. Note that, without yoo, this is not usually 
successful as it causes a read and write on the same file 
simultaneously. 


graphics(1G) 
gps(4), plot(4) in the Programmer’s Reference Manual 
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NAME 
head - give first few lines 


SYNOPSIS 
head [ -count | [ file... ] 


DESCRIPTION 
The head command is a filter which gives the first count lines of each of the 
specified files, or of the standard input. 


If count is omitted it defaults to 10. 


SEE ALSO 
tail(1) 
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NAME 
help - UNIX system Help Facility 


SYNOPSIS 
help 
[ help | starter 
[ help ] usage [ -d ] [ -e ] [ -o ] [ command name ] 
[ help ] locate [ keyword1 [ keyword2 ] ... ] 


[ help ] glossary [ term ] 
help arg ... 


DESCRIPTION 
The UNIX system Help Facility provides on-line assistance for UNIX system 
users, whether they desire general information or specific assistance for use of 
the Source Code Control System (SCCS) commands. 


Without arguments, help prints a menu of available on-line assistance commands 
with a short description of their functions. The commands and their descriptions 
are: 


COMMAND DESCRIPTION 


starter information about the UNIX system for the beginning user 

locate locate UNIX system commands using function-related 
keywords 

usage UNIX system command usage information 

glossary definitions of UNIX system technical terms 


The user may choose one of the above commands by entering its corresponding 
letter (given in the menu), or may exit to the shell by typing q (for "quit"). 


With arguments, help directly invokes the named on-line assistance command, 
bypassing the initial help menu. The commands starter, locate, usage, and 
glossary, optionally preceded by the word help, may also be specified at shell 
level. When executing glossary from shell level some of the symbols listed in the 
glossary must be escaped (preceded by one or more backslashes, \) to be 
understood by the Help Facility. For a list of symbols refer and how many 
backslashes to use for each, refer to the glossary(1) manual page. 


From any screen in the Help Facility, a user may execute a command wia the 
shell [sh(1)] by typing a ! and the command to be executed. The screen is 
redrawn if the command that was executed was entered at a first level prompt. If 
entered at any other prompt level, only the prompt is redrawn. 
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By default, the Help Facility scrolls the data that is presented to the user. If you 

prefer to have the screen clear before printing the data (non-scrolling), the shell 
variable SCROLL must be set to no and exported so it becomes part of your a, 
environment. This is done by adding the following line to your .profile file [see 

profile (4)]: “export SCROLL ; SCROLL=no". If you later decide that scrolling is 

desired, SCROLL must be set to yes. 


Information on each of the Help Facility commands (starter, locate, usage, 
glossary, and help) is located on their respective manual pages. 


The Help Facility can be tailored to a customer’s needs by use of the 
helpadm (1M) command. 


If the first argument to help is different from starter, usage, locate, or glossary, 

help assumes information is being requested about the SCCS Facility. The 

arguments may be either message numbers (which normally appear in 

parentheses following messages) or command names, of one of the following 

types: 

typel Begins with non-numerics, ends in numerics. The non-numeric prefix 1s 
usually an abbreviation for the program or set of routines which | | 
produced the message (e.g., ge3 for message 3 from the get command). Nad 


type2 Does not contain numerics (as a command, such as get). 


type3 Is all numeric (e.g., 212). 


SEE ALSO 
glossary(1), helpadm(1M), locate(1), sh(1), starter(1), usage(1) 
admin(1), cdce(1), comb(1), delta(1), get(1), prs(1), rmdel(1), sact(1), sccsdiff(1), 
unget(1), val(1), vc(1), what(1), profile(4), sccsfile(4), term(5) in the 
Programmer’s Reference Manual 


WARNINGS 
If the shell variable TERM [see sh (1)] is not set in the user’s .profile file, then 
TERM defaults to the terminal value type 450 (a hard-copy terminal). For a list 
of valid terminal types, refer to term (5). 
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NAME 
helpadm - make changes to the Help Facility database 


SYNOPSIS 
/etc/helpadm 


DESCRIPTION 
The command helpadm allows UNIX system administrators and command 
developers to define the content of the Help Facility database for specific 
commands and to monitor use of the Help Facility. The helpadm command can 
only be executed by login root, login bin, or a login that is a member of group 
bin. 
The helpadm command prints a menu of three types of Help Facility data which 
can be modified, and two choices relating to monitoring use of the Help Facility. | 
The five choices are: | 


- modify startup data 
- add, modify, or delete a glossary term 


- add, modify, or delete command data (description, options, examples, and 
keywords) 


- prevent monitoring use of the Help Facility (login root and login bin only) 
- permit monitoring use of the Help Facility (login root and login bin only) 


The user may make one of the above choices by entering its corresponding letter 
(given in the menu), or may exit to the shell by typing q (for quit). 


If one of the first three choices is chosen, then the user is prompted for 
additional information; specifically, which startup screen, glossary term definition, 
or command description is to be modified. The user may also be prompted for 
information to identify whether the changes to the database are additions, 
modifications, or deletions. If the user is modifying existing data or adding new 
data, then they are prompted to make the appropriate modifications/additions. If 
the user is deleting a glossary term or a command from the database, then they 
must respond affirmatively to the next query in order for the deletion to be done. 
In any case, before the user’s changes are final, they must respond affirmatively 
when asked whether they are sure they want their requested database changes to 
be done. 


By default, helpadm puts the user into ed(1) to make additions/modifications to 
database information. If the user wishes to be put into a different editor, then 
they should set the environment variable EDITOR in their environment to the 
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desired editor, and then export EDITOR. 


If the user chooses to monitor/prevent monitoring use of the Help Facility, the 
choice made is acted on with no further interaction by the user. 


SEE ALSO 
ed(1), glossary(1), help(1), locate(1), starter(1), usage(1) 


WARNINGS 
When the UNIX system is delivered to a customer, /etc/profile exports the 
environment variable LOGNAME. If /etc/profile has been changed so that 
LOGNAME is not exported, then the options to monitor/prevent monitoring use 
of the Help Facility may not work properly. 


FILES 
HELPLOG /usr/lib/help/HELPLOG 
helpclean /usr/lib/help/helpclean 
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NAME 
hp - handle special functions of Hewlett-Packard terminals 


SYNOPSIS 
hp [ -e ] [ -m ] 


DESCRIPTION 
The filter hp supports special functions of the Hewlett-Packard 2640 series of 
terminals, with the primary purpose of producing accurate representations of 
most nroff output. A typical usage is in conjunction with DOCUMENTER’ - 
WORKBENCH software: 


nroff -h files ... | hp 


Regardless of the hardware options on your terminal, hp tries to do sensible 
things with underlining and reverse line-feeds. If the terminal has the "display 
enhancements" feature, subscripts and superscripts can be indicated in distinct 
ways. If it has the "mathematical-symbol" feature, Greek and other special 
characters can be displayed. 


The flags are as follows: 

-e It is assumed that your terminal has the "display enhancements" feature, and 
sO maximal use is made of the added display modes. Overstruck characters 
are presented in the Underline mode. Superscripts are shown in Half- 
bright mode, and subscripts in Half-bright, Underlined mode. If this flag is 
omitted, hp assumes that your terminal lacks the "display enhancements" 
feature. In this case, all overstruck characters, subscripts, and superscripts 
are displayed in Inverse Video mode, i.e., dark-on-light, rather than the 
usual light-on-dark. 

-m Requests minimization of output by removal of newlines. Any contiguous 
sequence of three or more newlines is converted into a sequence of only 
two newlines; 1.e., any number of successive blank lines produces only a 
single blank output line. This allows you to retain more actual text on the 
screen. 


With regard to Greek and other special characters, hp provides the same set as 
does 300(1), except that "not" is approximated by a right arrow, and only the top 
half of the integral sign is shown. 


DIAGNOSTICS 
"line too long" if the representation of a line exceeds 1,024 characters. 
The exit codes are 0 for normal termination, 2 for all errors. 
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SEE ALSO 
300(1), greek(1) . 
col(1), eqn(1), nroff(1), tbl(1) in the DOCUMENTOR’S WORKBENCH N | 


reference manuals 


BUGS 
An "overstriking sequence" is defined as a printing character followed by a 
backspace followed by another printing character. In such sequences, if either 
printing character is an underscore, the other printing character is shown 
underlined or in Inverse Video; otherwise, only the first printing character is 
shown (again, underlined or in Inverse Video). Nothing special is done if a 
backspace is adjacent to an ASCII control character. Sequences of control 
characters (e.g., reverse line-feeds, backspaces) can make text "disappear"; in 
particular, tables generated by tb/(1) that contain vertical lines are often missing 
the lines of text that contain the "foot" of a vertical line, unless the input to Ap is 
piped through co/(1). 
Although some terminals do provide numerical superscript characters, no 
attempt is made to display them. 
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NAME 
hpio - Hewlett-Packard 2645A terminal tape file archiver 


SYNOPSIS 
hpio -ofrc] file ... 


hpio -i[rta] [-n count] 


DESCRIPTION 
The hpio command is designed to take advantage of the tape drives on Hewlett- 
Packard 2645A terminals. Up to 255 UNIX system files can be archived onto a 
tape cartridge for off-line storage or for transfer to another UNIX system. The 
actual number of files depends on the sizes of the files. One file of about 115,000 
bytes almost fills a tape cartridge. Almost 300 1-byte files fit on a tape, but the 
terminal is unable to retrieve files after the first 255. This manual page is not 
intended to be a guide for using tapes on Hewlett-Packard 2645A terminals, but 
tries to give enough information to be able to create and read tape archives and 
to position a tape for access to a desired file in an archive. 


hpio -o (copy out) copies the specified file(s), together with pathname and status 
information to a tape drive on your terminal (which is assumed to be positioned 
at the beginning of a tape or immediately after a tape mark). The left tape drive 
is used by default. Each file is written to a separate tape file and terminated with 
a tape mark. When pio finishes, the tape is positioned following the last tape 
mark written. 


hpio -i (copy in) extracts a file(s) from a tape drive (which is assumed to be 
positioned at the beginning of a file that was previously written by a hpio -o). 
The default action extracts the next file from the left tape drive. 


hpio always leaves the tape positioned after the last file read from or written to 
the tape. Tapes should always be rewound before the terminal is turned off. To 
rewind a tape depress the green function button, then function key 5, and then 
select the appropriate tape drive by depressing either function key 5 for the left 
tape drive or function key 6 for the right. If several files have been archived onto 
a tape, the tape may be positioned at the beginning of a specific file by 
depressing the green function button, then function key 8, followed by typing the 
desired file number (1-255) with no RETURN, and finally function key 5 for the 
left tape or function key 6 for the right. The desired file number may also be 
specified by a signed number relative to the current file number. 


The meanings of the available options are: 
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r Use the right tape drive. 

c Include a checksum at the end of each file. The checksum is always 
checked by hpio -i for each file written with this option by hpio -o. 

n count The number of input files to be extracted is set to count. If this option 
is not given, count defaults to 1. An arbitrarily large count may be 
specified to extract all files from the tape. hpio stops at the end of data 
mark on the tape. 

t Print a table of contents only. No files are created. Printed information 
gives the file size in bytes, the filename, the file access modes, and 
whether or not a checksum is included for the file. 

a Ask before creating a file. hpio -i normally prints the file size and name, 
creates and reads in the file, and prints a status message when the file 
has been read in. If a checksum is included with the file, it reports 
whether the checksum matched its computed value. With this option, 
the file size and name are printed followed by a ?. Any response 
beginning with y or Y causes the file to be copied in as above. Any 
other response causes the file to be skipped. 


FILES 
/dev/tty?? to block messages while accessing a tape 


SEE ALSO 
cu(1C) 


DIAGNOSTICS 

BREAK 
An interrupt signal terminated processing. 

Can’t create 7file’. 
File system access permissions did not allow file to be created. 

Can’t get tty options on stdout. 
hpio was unable to get the input-output control settings associated with the 
terminal. 

Can’t open ’file’. 
File could not be accessed to copy it to tape. 

End of Tape. 
No tape record was available when a read from a tape was requested. An 
end of data mark is the usual reason for this, but it may also occur if the 
wrong tape drive is being accessed and no tape is present. 

File is a directory or other special file. Only regular files are copied to tape. 

Readcnt = rc, termcnt = fc. 
hpio expected to read rc bytes from the next block on the tape, but the 
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block contained fc bytes. This is caused by having the tape improperly 
positioned or by a tape block being mangled by interference from other 
terminal [/O. 

Skip to next file failed. 
An attempt to skip over a tape mark failed. 

Tape mark write failed. 
An attempt to write a tape mark at the end of a file failed. 

Write failed. 
A tape write failed. This is most frequently caused by specifying the wrong 
tape drive, running off the end of the tape, or trying to write on a tape that 
is write protected. 


WARNINGS 
Tape I/O operations may copy bad data if any other I/O involving the terminal 
occurs. Do not attempt any type ahead while Apio is running. Apio turns off 
write permissions for other users while it is running, but processes started 
asynchronously from your terminal can still interfere. The most common 
indication of this problem, while a tape is being written, is the appearance of 
characters on the display screen that should have been copied to tape. 


The keyboard, including the terminal BREAK key, is locked during tape write 
operations; the BREAK key is only functional between writes. 


hpio must have complete control of the attributes of the terminal to communicate 
with the tape drives. Interaction with commands such as cu(1C) may interfere 
and prevent successful operation. 


BUGS 
Some binary files contain sequences that confuse the terminal. 


An hpio -i that encounters the end of data mark on the tape (e.g., scanning the 
entire tape with hpio -itn 300), leaves the tape positioned after the end of data 
mark. If a subsequent hpio -o is done at this point, the data is not retrievable. 
The tape must be repositioned manually using the terminal FIND FILE -1 
operation (depress the green function button, function key 8, and then function 
key 5 for the left tape or function key 6 for the right tape) before the hpio -o is 
started. 


If an interrupt is received by hpio while a tape is being written, the terminal may 
be left with the keyboard locked. If this happens, the terminal’s RESET 
TERMINAL key unlocks the keyboard. 
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NAME 
iconv - code set conversion 


e~ 


SYNOPSIS 
iconv -f fromcode -t tocode [-m mode] [-d database] [file(s)] 


DESCRIPTION 
The iconv command converts the encoding of characters in file(s) from one code 
set to another and writes the results to standard output. 


The required arguments fromcode and tocode identify the input and output code 
sets, respectively. The optional argument mode provides a further distinction 
between mulitple code set maps for the same fromcode and tocode. The optional 
argument database specifies a database to be used instead of the default 
database /usr/lib/kbd/iconv_data. If no file(s) arguments are specified on the 
command line, iconv reads the standard input. 


The iconv command uses a database with four required fields fromcode, tocode, 

table, file and one optional field mode. The order of the database fields is as 

named previously. The database fields are separated by spaces or tabs, and the 
e~, database rows are separated by newlines. 


The iconv command matches the required arguments fromcode and tocode and 
the optional argument mode to the corresponding fields in the database. Ifa 
match is found, iconv calls kbdpipe with the appropriate table and file fields; 1.e., 
kbdpipe -t table -F file, where table is the mapping between fromcode and tocode 
(with optional mode), and file contains table. 


The field mode does not have to be uniformly included or excluded from the 
database; (i.e., it may be included in some rows and not in others). If the 
argument mode is not included in the iconv command line, iconv matches the first 
row found that contains the correct fromcode and tocode fields, ignoring any 
mode fields. 


The naming conventions in the database are left entirely up to the user. 

However, absolute pathnames are required for file fields not located in 

/usr/lib/kbd, as kbdpipe assumes that any file in the -F file argument that does not 
‘™~ begin with "/" is found in /usr/lib/kbd. 
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The codeset conversions supported in the supplied database are given in the 
following table: 


Code Set Conversions Supported 


88591 


fromcode 


tocode 
ASCII 


modes 


6937 88591 d Teletext 

88591 6937 d Teletext 

646 88591 dbep US ASCII 
646DE 88591 d German 
646DK 88591 d Danish 
646GB 88591 d English ASCII 
646ES 88591 d Spanish 
646FR 88591 d French 

646IT 88591 d Italian 

646NO 88591 d Norwegian 
646SE 88591 d Swedish 
88591 646 d 7 bit ASCII 
88591 646DE dbep German 
88591 646DK dbep Danish 

88591 646GB dbep_ English ASCII 
88591 646ES dbep Spanish 

88591 646FR dbep_ French 

88591 646IT dbep Italian 

88591 646NO dbep Norwegian 


comment 


Swedish 


ibm_ebcdic 
The fromcodes and tocodes 88591, 646, and 6937 correspond to the International 
Standards ISO 8859-1, ISO 646, and ISO 6937 respectively. 

The optional modes, d, b, e, and p have the following meanings: 


d default 
Any character that cannot be represented is mapped to the ultimate 
fall back character, which in the tables supplied, is the underscore 
character (_). 
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b best fit with no expansion 


Characters are, where possible, mapped to the closest approximation 
of that character but always without expansion; (i.e., all the character 
mappings are one-to-one). This is important, for example, when using 
curses-based applications where any expansion of a character 
representation would affect the screen management. (If such code set 
mappings are performed by the STREAMS-module in the tty 
subsystem, then such mappings are transparent and the application will 
have no knowledge that these mappings take place.) 


e best fit with expansion 


Characters of the source code set are, where possible, mapped to the 
closest approximation of that character in the target code set. Where 
necessary the character in the source code set is expanded toa 
sequence of characters in the target code set. 


Pp __ printer mode - with overstriking 


Cy 


If there is a nondestructive backspace, as exists on many printers, then 
some characters that are not available can be displayed by overstriking. 
In this way many accented characters can be displayed. 


RETURN VALUES 
Returns 0 upon successful completion, 1 otherwise. 


EXAMPLES 


An example of a database for iconv is shown below, with the following fields 
(field names are not included in the database): 


fromcode 


88591 
88591 
646 


tocode table file mode 
6937 88591.6937.b _ pubfile b 
6937 pubtable 88591.6937.d.t. d 
646DE togerman /mydir/togerman 


Using the preceding database, the following converts the contents of files mail1 
and mail2 from code set 88591 to 6937 using bestfit mode and stores the results in 
file mail local. 


iconv -f 88591 -t 6937 -m bestfit mail1 mail2 > mail.local 


The following accomplishes the same result as previously shown, as the bestfit 
mode from code set 88591 to 6937 will be the first row containing the correct 


match. 


iconv -f 88591 -t 6937 maill mail2 > mail.local 
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FILES 
/usr/lib/kbd/iconv_data default database - 


NOTES VA 
The STREAMS pipe device (/dev/spx) and the STREAMS tty subsystem are 
used by kbdpipe and must be installed on the system. 


SEE ALSO 
kbdpipe(1), kbdset(1) 
kbdload(1M) in Administrator’s Reference Manual 


Cc 4 
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NAME 
id - print user and group IDs and names 


SYNOPSIS 
id 


DESCRIPTION 
The command id outputs the user and group IDs and the corresponding names 
of the invoking process. If the effective and real IDs are different, both are 
printed. 


SEE ALSO 


logname(1) 
getuid(2) in the Programmer’s Reference Manual 
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NAME 
ifilter - international line printer filter 


SYNOPSIS 
ifilter -C [ CHAR SET ] -P [ printer model ] -o output_file input_filename 


DESCRIPTION 
The filter ifi/ter is to be used with direct I/O to a named printer port, as with the 
use of cat. 


If you use the -o option, you must choose the name of the output file. If you do 
not use the -o option, the output filename is the original filename concatenated 
with a .fil suffix. 


Character Sets Supported 
Names are limited to eight characters. Supported entries for CHARSET are: 


BRITISH ITALIAN 
CANADIAN NORTH 
DANISH NORWEGIA 
DUTCH SPANISH 
FINNISH SWEDISH 
FLEMISH SWISS-FR 
FRENCH-B SWISS-GE 
GERMAN 

Models 


Supported entries for printer model are noted in the "filter name" column below: 


Filter Name Menu/Ipadmin Model Name 


25B ssp25 or spp25 
ise .. ssp25 or spp25 
031 ssp31 

035 ssp35 or spp35 
037 ssp37 or spp37 
047 ssp47 or ssp47hs 
105 ssp105 or spp105 
115 ssp115 or spp115 
789 ssp789 

1307 ssp1307 
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EXAMPLES 


ssp1327 or spp1327 
ssp1329 or spp1329 
ssp9215 or spp9215 
ssp9246 or spp9246 


The following would convert a file chars, created using the French-Canadian 
character set, to an output file named frchcan.chars for printing on a 0789 printer: 


ifilter -C CANADIAN -P 789 -o frchcan.chars chars 


FILES 


/usr/spool/lp/TABLES 


SEE ALSO 
ilp(1) 
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NAME 
ilp - send requests to an LP line printer using an international character set 


SYNOPSIS 
ilp [-c] [-ddest] [-m] [-nnumber] [-ooption] [-s] [-ttitle] [-w] files 


DESCRIPTION 
The command ilp arranges for the named files and associated information 
(collectively called a request) to be printed by a line printer using an international 
character set. If no filenames are mentioned, the standard input is assumed. 
The filename - stands for the standard input and may be supplied on the 
command line along with named files. The order in which files appear is the 
same order in which they are printed. 


Ilp associates a unique JD with each request and prints it on the standard output. 
This JD can be used later to cancel [see cancel(1)] or find the status [see 
Ipstat(1)] of the request. 


The international language character set used by i/p is determined by which 
printer is specified. The association between a printer and its language is 
specified in /usr/spool/lp/prsetup. Refer to prsetup(4) for more information. 


OPTIONS 

The following options to ijp may appear in any order and may be intermixed with 

filenames: 

-C Make copies of the files to be printed immediately when ilp is 
invoked. Normally, files are not copied, but are linked whenever 
possible. If the -c option is not given, then the user should be careful 
not to remove any of the files before the request has been printed in 
its entirety. Also, in the absence of the -c option, any changes made 
to the named files after the request is made but before it is printed 
are reflected in the printed output. 

-ddest Choose dest as the printer or class of printers that is to do the 


printing. If dest is a printer, then the request is printed only on that 
specific printer. If dest is a class of printers, then the request is 
printed on the first available printer that is a member of the class. 
Under certain conditions (printer unavailability, file space limitation, 
etc.), requests for specific destinations may not be accepted [see 
accept(1M) and Ipstat(1)]. By default, dest is taken from the 
environment variable LPDEST (if it is set). Otherwise, a default 
destination (if one exists) for the computer system is used. 
Destination names vary between systems [see /pstat(1)]. 
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-m Send mail [see mail(1)] after the files are printed. No mail is sent 
upon normal completion of the print request unless -m is specified. 
-nnumber Print number copies (default of 1) of the output. a 


-ooption Specify printer-dependent or class-dependent options. Several such 
options may be collected by specifying the -o keyletter more than 
once. For valid options, see Models in lpadmin (1M). 


-S Suppress messages from i/p(1) such as request ID is... 
-taitle Print title on the banner page of the output. 
-W Write a message on the terminal after the files are printed. If the 


user is not logged in, then mail is sent instead. 


FILES 
/usr/spool/p/* 
/usr/spool/lp/prsetup (must be present) 
/usr/spool/lp/TABLES/* 


SEE ALSO | 
cancel(1), enable(1), ifilter(1), lp(1), Ipstat(1), mail(1), WwW 
-accept(1M), lpadmin(1M), Ipsched(1M) in the Administrator’s Reference 
Manual 
prsetup(4) in the Programmer’s Reference Manual 
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NAME 
ipcrm - remove a message queue, semaphore set or shared memory ID 


SYNOPSIS 
iperm [ options | 


DESCRIPTION 
The ipcrm command removes one or more specified messages, semaphore or 
shared memory identifiers. The identifiers are specified by the following options: 


-q msqid removes the message queue identifier msqid from the system and 
destroys the message queue and data structure associated with it. 


-m shmid removes the shared memory identifier shmid from the system. The 
shared memory segment and data structure associated with it are 
destroyed after the last detach. 


-s sernid removes the semaphore identifier sernid from the system and 
destroys the set of semaphores and data structure associated with 
it. 


-Q msgkey removes the message queue identifier, created with key msgkey, 
from the system and destroys the message queue and data 
structure associated with it. 


-M shmkey _ removes the shared memory identifier, created with key shmkey, 
from the system. The shared memory segment and data structure 
associated with it are destroyed after the last detach. 


-S semkey removes the semaphore identifier, created with key semkey, from 
the system and destroys the set of semaphores and data structure 
associated with it. 


The details of the removes are described in msgctl(2), shmctl(2), and serncti(2). 
The identifiers and keys may be found by using ipcs(1). 


SEE ALSO 
ipcs(1) 
msgctl(2), msgget(2), msgop(2), semctl(2), semget(2), semop(2), shmctl(2), 
fn shmget(2), shmop(2) in the Programmer’s Reference Manual 
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NAME 
ipcs - report inter-process communication facilities status 


SYNOPSIS 
ipcs [ options ] 


DESCRIPTION 
The ipcs command prints certain information about active inter-process 
communication facilities. Without options, information is printed in short format 
for message queues, shared memory, and semaphores that are currently active in 
the system. Otherwise, the information that is displayed is controlled by the 


following options: 

-q Print information about active message queues. 

-m Print information about active shared memory segments. 
-S Print information about active semaphores. 


If any of the options -q, -m, or -s are specified, information about only those 
indicated is printed. If none of these three are specified, information about all 
three is printed subject to these options: 


-b _— Print biggest allowable size information. (Maximum number of bytes in 
messages on queue for message queues, size of segments for shared 
memory, and number of semaphores in each set for semaphores.) See 
below for meaning of columns in a listing. 


-c ‘Print creator’s login name and group name. See below. 


-o Print information on outstanding usage. (Number of messages on queue 
and total number of bytes in messages on queue for message queues and 
number of processes attached to shared memory segments.) 


-p Print process number information. (Process ID of last process to send a 
message and process ID of last process to receive a message on message 
queues and process ID of creating process and process ID of last process 
to attach or detach on shared memory segments.) See below. 


-t ‘Print time information. (Time of the last control operation that changed 
the access permissions for all facilities. Time of last msgsnd and last msgrcv 
on message queues, last shmat and last shmdt on shared memory, last 
semop(2) on semaphores.) See below. 
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-a___ Use all print options. (This is a shorthand notation for -b, -c, -o, -p, and 
-t.) 


-C corefile 
Use the file corefile in place of /dev/kmem. 


-N namelist 
The argument is taken as the name of an alternate namelist (/unix is the 
default). 


The column headings and the meaning of the columns in an ipcs listing are given 
below; the letters in parentheses indicate the options that cause the 
corresponding heading to appear; all means that the heading always appears. 
Note that these options only determine what information is provided for each 
facility; they do not determine which facilities will be listed. 


T (all) Type of the facility: 
q message queue; 


m = shared memory segment; 


S semaphore. 
ID (all) The identifier for the facility entry. 
KEY (all) The key used as an argument to msgget, sermget, or shmget to 


create the facility entry. (Note: The key of a shared memory 
segment is changed to IPC_PRIVATE when the segment has 
been removed until all processes attached to the segment 
detach it.) 


MODE (all) The facility access modes and flags. The mode consists of 11 
characters that are interpreted as follows. The first two 
characters are: 


Rif a process is waiting on a msgrcv; 
S if a process is waiting on a msgsnd; 


D ___ if the associated shared memory segment has been 
removed. It disappears when the last process 
attached to the segment detaches it; 


C if the associated shared memory segment is to be 
cleared when the first attach 1s executed; 
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OWNER 
GROUP 


CREATOR 
CGROUP 


CBYTES 
QNUM 
QBYTES 
LSPID 
LRPID 


STIME 
RTIME 


CTIME 
NATTCH 


SEGSZ 


CPID 
LPID 
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- if the corresponding special flag is not set. 


The next nine characters are interpreted as three sets of three bits 


each. 


The first set refers to the owner’s permissions; the next to 


permissions of others in the user-group of the facility entry; and the 
last to all others. Within each set, the first character indicates 
permission to read, the second character indicates permission to 
write or alter the facility entry, and the last character is currently 
unused. The permissions are indicated as follows: 


(all) 
(all) 


(a,c) 
(a,c) 


(a,0) 
(a,0) 
(a,b) 
(a,p) 
(a,p) 


(a,t) 
(a,t) 


(a,t) 
(a,0) 


(a,b) 
(a,p) 
(a,p) 


if read permission is granted; 
if write permission 1s granted; 
if alter permission is granted; 
if the indicated permission is not granted. 


(pega 


The login name of the owner of the facility entry. 

The group name of the group of the owner of the facility 
entry. 

The login name of the creator of the facility entry. 

The group name of the group of the creator of the facility 
entry. 

The number of bytes in messages currently outstanding on the 
associated message queue. 

The number of messages currently outstanding on the 
associated message queue. | 

The maximum number of bytes allowed in messages 
outstanding on the associated message queue. 

The process ID of the last process to send a message to the 
associated queue. 

The process ID of the last process to receive a message from 
the associated queue. 

The time the last message was sent to the associated queue. 
The time the last message was received from the associated 
queue. 

The time when the associated entry was created or changed. 
The number of processes attached to the associated shared 
memory segment. 

The size of the associated shared memory segment. 

The process ID of the creator of the shared memory entry. 
The process ID of the last process to attach or detach the 
shared memory segment. 
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ATIME _ (a,t)_ The time the last attach was completed to the associated | 
shared memory segment. , 
DTIME (a,t) The time the last detach was completed on the associated / 
shared memory segment. 
NSEMS (a,b) The number of semaphores in the set associated with the 
semaphore entry. 
OTIME (a,t) The time the last semaphore operation was completed on the 
set associated with the semaphore entry. 


/unix system namelist 
/dev/‘kmem memory 
/etc/passwd user names 
/etc/group group names 


SEE ALSO 
msgop(2), semop(2), shmop(2) in the Programmer’s Reference Manual 


BUGS | 
Things can change while ipcs is running; the picture it gives is only a close x y 
approximation to reality. 7 
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NAME 
isastream - test for a STREAMS device special file 


Cy SYNOPSIS 


isastream [device {| -] 


DESCRIPTION 
The isastream utility is used to test for a STREAMS device special file. A 
pathname is given as an argument. Standard input (usually the login terminal) 
can be specified by a - (dash). 


The specified pathname is opened using the flag O NDELAY. This means that 
it always returns control to the calling utility, even if the STREAM 1s connected 
to an offline TTY device. 


The utility uses isastream(3) to do the test and then reports on the result. A 
usage report is printed in the absence of a pathname. 


RETURN VALUES 
All output is sent to the standard error file. If the argument is a STREAMS 
f~ device file then the exit code is 0. In the case of error or a nonSTREAMS 
device file, the exit code is 1. 


EXAMPLES 
$ isastream /dev/log 
/dev/log is a stream 
$ isastream - 
stdin is a stream 
$ isastream /usr/tmp/foo 
/usr/tmp/foo is not a stream 


SEE ALSO 
open(2) in the Programmer’s Reference Manual 
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NAME 
isort - sort and/or merge files 


SYNOPSIS 
isort [-cmu] [-ooutput] [-ykmem] [-zrecsz] [-dfnr] [-llang] [-btx] [+ pos1 
[-pos2] ] [files] 


DESCRIPTION 
The isort (international sort) command sorts, according to the collating rules of 
the specified language, lines of all the named files together and writes the result 
on the standard output. The standard input is read if - is used as a filename or 
no input files are named. 


Comparisons are based on one or more sort keys extracted from each line of 
input. By default, there is one sort key, the entire input line, and ordering is 
lexicographic by bytes in machine collating sequence. 


OPTIONS 
The following options alter the default behavior: 


-c Check that the input file is sorted according to the ordering rules; give no 
output unless the file is out of sort. 


-m Merge only, the input files are already sorted. 
-u_ Unique: suppress all but one in each set of lines having equal keys. 


-ooutput 
Use the argument given as the name of an output file instead of the 
standard output. This file may be the same as one of the inputs. 


-ykmem 
The amount of main memory used by the sort has a large impact on its 
performance. Sorting a small file in a large amount of memory is a waste. 
If this option is omitted, isort begins using a system default memory size, 
and continues to use more space as needed. If this option is presented 
with a value, nem, isort starts using that number of kilobytes of memory, 
unless the administrative minimum or maximum is violated, in which case 
the corresponding extremum is used. Thus, -y0 is guaranteed to start with 
minimum memory. 


~ZFECSZ | 
The size of the longest line read is recorded in the sort phase so buffers 
can be allocated during the merge phase. If the sort phase is omitted via 
the -c or -m option, a popular system default size is used. Lines longer 
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than the buffer size cause isort to terminate abnormally. Supplying the 
actual number of bytes in the longest line to be merged (or some larger 
value) prevents abnormal termination. The record size cannot be larger 
than 512 bytes. 


The following options override the default ordering rules. 


-d__ Dictionary order: only letters, digits and blanks (spaces and tabs) are 
significant in comparisons. Cannot be combined with -f. 


-f Fold lowercase letters into uppercase. Cannot be combined with -d. 


-| Language. Use the corresponding 1- or 2-character abbreviation from the 
following table. If no language is specified, the default is US (or ASCID. 


US United States (or ASCI) 
UK United Kingdom (England) 
N Norway/Denmark 

NL Holland 

SF Finland 

F France 

B Belgium 

Q French-speaking Canada 
D Germany 

A Austria 

I Italy 

E Spain 

S Sweden 

CH Switzerland 

U User-defined 


A user-defined table (currently set to ASCII) is provided. It can be 
changed to the language desired according to the rules in isort(4). 


-n An initial numeric string, consisting of optional blanks, optional minus sign, 
and zero or more digits with optional decimal point, is sorted by arithmetic 
value. The -n option implies the -b option (see below). Note that the -b 
option is only effective when restricted sort key specifications are in effect. 


-r Reverse the sense of comparisons. 


When ordering options appear before restricted sort key specifications, the 
requested ordering rules are applied globally to all sort keys. When attached to 
a specific sort key (described below), the specified ordering options override all 
global ordering options for that key. 
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The notation +pos1 -pos2 restricts a sort key to one beginning at pos] and 
| c™ ending at pos2. The characters at positions pos! and pos2 are included in the 

} sort key provided that pos2 does not precede pos]. A missing -pos2 means the 
end of the line. 


| Specifying posI and pos2 involves the notion of a field, a minimal sequence of 
characters followed by a field separator or a newline. By default, the first blank 
(space or tab) of a sequence of blanks acts as the field separator. All blanks in a 
sequence of blanks are considered to be part of the next field; for example, all 

| blanks at the beginning of a line are considered to be part of the first field. The 
treatment of field separators can be altered using the options. 


| -& Usexas the field separator character; x 1s not considered to be part of a 
| field although it may be included in a sort key. Each occurrence of x is 
significant (e.g., xx delimits an empty field). 


-b _— Ignore leading blanks when determining the starting and ending positions 

| of a restricted sort key. If the -b option is specified before the first + pos 

| argument, it is applied to all +pos/] arguments. Otherwise, the b option 

\ i may be attached independently to each + pos/ or -pos2 argument (see 
below). 


Pos!1 and pos2 each have the form mn optionally followed by one or more of the 
options bdfnr. A starting position specified by +m. is interpreted to mean the 
n+1st character in the m + 1st field. A missing means .0, indicating the first 
character of the m + 1st field. If the b option is in effect n is counted from the 
first non-blank in the m + 1st field; +71 .0b refers to the first non-blank character 
in the m + Ist field. 


A last position specified by -m is interpreted to mean the mth character 
including separators after the last character of the m th field. A missing » means 
.0, indicating the last character of the mth field. If the b option is in effect n 1s 
counted from the last leading blank in the m + 1st field; -m.1b refers to the first 
non-blank in the m + Ist field. | 


i re + 


| When there are multiple sort keys, later keys are compared only after all earlier 
keys compare equal. Lines that otherwise compare equal are ordered with all 


bytes significant. 
co 


EXAMPLES 
Sort the contents of infile with the second field as the sort key: 


isort +1 -2 infile 
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Sort, in reverse order, the contents of infile1 and infile2, according to the rules 
for Swedish, placing the output in outfile and using the first character of the ™ 
second field as the sort key: 


isort -r -IS -ooutfile +1.0 -1.2 infile1 infile2 


Sort, in reverse order, the contents of infile1 and infile2 using the first non-blank 
character of the second field as the sort key: 


isort -r +1.0b -1.1b infile1 infile2 


Print the password file [passwd(4)] sorted by the numeric user ID (the third 
colon-separated field): 


isort -t: +2n -3 /etc/passwd 


Print the lines of the already sorted file infile, suppressing all but the first 
occurrence of lines having the same third field (the options -um with just one 
input file make the choice of a unique representative from a set of equal lines 
predictable): 


isort -um +2 -3 infile 


FILES Nea 


/usr/tmp/stm??? 
/usr/spool/isort/TABLE/* 
/usr/spool/isort/ERRORS/* 


SEE ALSO 


comm(1), join(1), uniq(1) 
isort(4) in the Programmer’s Reference Manual 


DIAGNOSTICS 


Error messages are contained in /usr/spool/isort/ERRORS /language (e.g., 
SWEDEN). These files may be changed to local language statements if desired. 


Comments and exits with non-zero status for various trouble conditions (e.g., 
when input lines are too long), and for disorder discovered under the -c option. 


When the last line of an input file is missing a newline character, isort appends 
one, prints a warning message, and continues. ' | 
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RESTRICTIONS | 
a’ isort outputs files without truncation if the file has up to 46,380 lines of up to 512 
| characters per line. isort outputs files with truncation (and displays an error 
message) if the file exceeds 12,488 characters or 1561 lines and the line length 
exceed 512 characters. 


The options -d and -f are mutually exclusive. 
The options -M and -i are supported in sort(1), but in isort(1) they are ignored. 


With the -z option the maximum record size allowed is 512 bytes. Any line longer 
than 512 bytes is truncated to 512 bytes. 
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NAME 
| join - relational database operator 


SYNOPSIS 
join [ options ] filel file2 


| DESCRIPTION 
| The join command forms, on the standard output, a join of the two relations 
specified by the lines of file] and file2. If file] is -, the standard input is used. 


File1 and file2 must be sorted in increasing ASCII collating sequence on the 
fields on which they are to be joined, normally the first in each line [see sort(1)]. 


| There is one line in the output for each pair of lines in file] and file2 that have 
| identical join fields. The output line normally consists of the common field, then 
the rest of the line from fi/e], then the rest of the line from file2. 


The default input field separators are blank, tab, or newline. In this case, 
| multiple separators count as one field separator, and leading separators are 
| ignored. The default output field separator is a blank. 


L Some of the below options use the argument. This argument should be a 1 or 
a 2 referring to either file or file2, respectively. The following options are 
recognized: 


-an In addition to the normal output, produce a line for each unpairable line 
in file n, where n is 1 or 2. 


-es Replace empty output fields by string s. 


-jn m Join on the mth field of filen. Ifn is missing, use the mth field in each 
file. Fields are numbered starting with 1. 


-o list Each output line comprises the fields specified in list, each element of 
which has the form nym, where n is a file number and m is a field 
number. The common field is not printed unless specifically requested. 


“tc Use character c as a separator (tab character). Every appearance of c in 
a line is significant. The character c is used as the field separator for both 
input and output. 


c~ 


Internationalization 
The join command can process characters from supplementary code sets, as well 
as ASCII characters. 
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| 
Options: | 

-es The string s to be replaced can contain supplementary characters. | ) 


EXAMPLES 
The following command line joins the password file and the group file, matching 
on the numeric group ID, and outputting the login name, the group name and the | 
login directory. It is assumed that the files have been sorted in ASCII collating | 
sequence on the group ID fields. 


-tc The separator c can be a character from the supplementary code sets. 
| 


join -j1 4 -j2 3 -o 1.1 2.1 1.6 -t: /etc/passwd /etc/group 


SEE ALSO 
awk(1), comm(1), sort(1), uniq(1) 


BUGS | 
With default field separation, the collating sequence is that of sort -b; with -t, the 
sequence is that of a plain sort. 


The conventions of join, sort, comm, unig and awk(1) are wildly incongruous. a 


Filenames that are numeric may cause conflict when the -o option is used right 
before listing filenames. | 
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NAME 
kbdcomp - compile kbd tables 


( SYNOPSIS 


kbdcomp [-vrR] [-o outfile] [infile] 


DESCRIPTION 
The kbdcomp command compiles the tables for use with the kbd(7) STREAMS 
module, a programmable string-translation module. The module has two 
separate abilities, each of which may be used alone or in combination. 


The first ability, lookup, is that of performing simple substitutions of bytes in an 
input stream. This ability is based on a simple 256-entry lookup table (as there 
are 256 possible bit combinations for a byte). As input is received, each byte is 
looked up in the translation table, and the table value for that byte is substituted 
in place of the original byte. The process 1s quick, and can be performed on 
each STREAMS message with no message copying or duplication. 


The second ability, mapping, allows searching for occurrences of specified strings 
| of bytes (or individual bytes) in an input stream, and substituting other strings (or 
i bytes) for them as they are recognized. There are three kinds of mapping that 

| are differentiated by the relationship between the number of bytes in the input 

and the number of bytes in the output. "One-many" mapping means that for a 

given byte in the input, many bytes are substituted. "Many-one" includes the 

other two types as a proper subset, but also includes substitution of many bytes in 
the input with many bytes of output. The kbd compiler can perform all three 

types of mapping. The lookup ability described in the previous paragraph (i.e. 

what amounts to "one-one" mapping) is a common special case useful enough to 

be included separately. By using combinations of both lookup and mapping, a 

larger class of input translation and conversion problems can be solved than can 

be solved by the use of either alone. 


During operation, processing occurs in two major passes: the lookup table pass 
always precedes string mapping. The string mapping procedure is nonrecursive 
for a given table and there is no feedback mechanism (that is, input is scanned in 
the order received and output is not rescanned for occurrences of recognizable 
input strings). As an example of mapping, suppose one wishes to translate all 

ie | occurrences of the string this in an input stream into the string there. The 

wy module recognizes and buffers occurrences of the string th (as each byte is 
received); if the following character is i, it is also buffered, but if x is then 
received, a mismatch is recognized and no translation occurs. Assuming thi has 
been buffered, if the next character seen is s, a match is recognized, the buffer 
containing this is discarded, and the string there replaces it. 
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It should be obvious that both input and output strings can be of any nonzero 

length (see RESTRICTIONS following). Each string to be recognized and - 
translated must be unique, and no complete input string may constitute the q P 
leading substring of any other (e.g., you may not define abe and ab oF 
simultaneously, but you may so define abc, agd, and abxy). 


Given a filename (or standard input if no name is supplied), kbdcomp compiles 
tables into the output file specified by the -o option. If the -o option is not 
supplied, output is to the file kbd.out. 


The -v option causes parsing and verification; no output file is produced. If no 
error messages are printed, then the input file is syntactically correct. The -r 
option causes the compiler to check for and report on byte values that cannot be 
generated in a table (see the description following). The option -R is equivalent 
to -r, but tries to print printable characters as themselves rather than in octal 
format. 


Input Language 
Source files for kbdcomp are a series of table declarations. Within each table 
declaration are a number of definitions and functions. A table declaration is one 


of the forms map or link: | 
map type ( name ) {expressions} 
link ( string ) 


The link form is described in text which follows. The name of a map must be a 
simple token not containing any colons, commas, quotes, or spaces. (For our 
purposes, a simple token is a sequence of alphabetic and/or numeric characters 
with no embedded punctuation, whitespace, or special symbols.) The type field is 
an optional field that may be either of the keywords, full or sparse. If omitted, 
the type defaults to sparse. The effect of this field is described in more detail 
following. The expressions contained in the map declaration are one of the 
following forms. Reserved keywords are printed in constant-width font, variables 
in italics: 

keylist ( string string ) 

define ( word value ) 

word ( extension result ) 

string ( word word ) 

strlist ( string string ) 

error ( string ) 

timed 
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The keylist form is for defining lookup table entries while the remaining forms 
are the separate string functions. 


The definition form (define) allows a mnemonic word (the first argument) to be 
associated with a string (the second argument). It is useful for replacing 
complicated sequences (e.g., those containing special symbols or control 
characters) with mnemonic words to facilitate the design and readability of 
tables. 


Using the word form (where word must be a previously defined sequence) in a 
manner similar to a C function call results in the value of word being 
concatenated with extension; when the combination is recognized, it is mapped to 
result. The value may be a string of characters or a single byte. The following is 
an illustration (not intended to be complete): 


map (some accents) { 


def ine(acute '\047') 
def ine(grave '~') 
acute(a '\341') # same as string("\047a" "\341") 
grave(a '\340') 
# ...et cetera... 
keylist("zyZY" "yzYZ") 
} 


This map defines the single quote and reverse quote keys as "dead-keys" which, 
when followed by a, produce a character from the ISO 8859-1 code set. It is not 
necessary for the definition, extension, or result to be a single byte; they may be 
arbitrary strings. 


Strings in definitions and arguments may generally be entered either without 
quotation or between double quotes. Byte constants may likewise be entered 
unquoted or between single quotes. The only time quotation is strictly required 
is when the string contains parentheses, spaces, tab characters, or other special 
symbols. The language makes no real distinction between byte constants and 
string constants: both are treated as null-terminated strings; the choice of 
whether to use a one-character string or a byte constant is thus a matter of taste. 
Most quoting conventions of C are recognized, except that octal constants must 
be exactly three digits long. Octal constants may be used in strings as well. In 
the example above, the arguments to keylist need not be quoted, as they contain 
no special symbols. The following example illustrates some situations where 
strings must be quoted: 
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string(abc "two words") # literal space 

keylist("[{}]""(())") # brackets/parentheses — 
def ine(esc_seq"\033\t(") # tab and parentheses 
def ine(space ' ') # literal space 

string(abc "keylist”) # keyword used as argument 


Comments in files (inside or outside of map declarations) may be entered in the 
same manner as for sh(1); that is, after a # at the end of a line, or on a line 
beginning with a #, as shown in the previous example. 


The keylist form allows single bytes to be mapped to other single bytes; it defines 
actions that are treated in the lookup table (i.e., are performed before mapping). 
Any byte value that is not explicitly changed by being included in a keylist form 
is, of course, left unchanged; if no keylist forms appear in a map definition, then 
kbdcomp does not generate a lookup table for the map, and the lookup phase is 
skipped during module operation. Each byte in the first string argument to 
keylist is mapped to the byte at the same position in the second string argument. 
That is, given two strings X and Y as arguments: Xi maps to Yi, Xj maps to Yj 
and so forth. The two arguments must evaluate to strings containing the same 


number of bytes. 

The string form has a function similar to mnemonic forms defined with define WY 
and may be used for any type of many-many mapping. The first argument to 

string is mapped to the second argument (see the comment in the sample map 

above). 


Mappings using both keylist and string or any define forms may be combined. If 
i is mapped to a with a keylist form, and a is used in the sequence ~ a, then 
when the user types ‘i, the sequence ~ a is seen by the string mapping process 
(because lookup is done first) and translated accordingly. 


The keylist form is intended mainly for use in simple keyboard rearrangement 
and case-conversion applications; string is for one-many mapping or for isolated 
instances of many-many mapping; the define form and words defined with it are 
intended for more general use in groups of related sequences. In some situations 
while a one-one mapping with keylist may be an obvious choice, the same effect 
may be achieved with string forms to avoid having a contradictory mapping. 


For example, suppose one desires, simultaneously, to translate x into y and y into J 
abc. If x is mapped to y by a keylist form and y is mapped to abc by a string 

form, then it may be impossible to obtain y itself (uniess defined in another 
sequence), even though that was not the intention; the intention was to obtain y 
whenever the user enters x. Following is an example of a contradictory mapping: 
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keylist (x y) 
string(y abc) #"y" itself cannot be generated 


There are cases where the intention is that y not be generated, but most often the 
intention is to generate it. This problem (a relatively common one in code set 
mapping) can be solved by using a string form to map x to y initially rather than 
using a keylist form. This allows both y and abc to be generated: 


string(x y) 
string(y abc) 


Entering a large number of one-one mappings with string can be somewhat 
tedious. To make things easier, the strlist form is provided. The two string 
arguments to strlist are interpreted in the same manner as arguments to keylist 
(i.e., they are one-one mappings); however, they are not done by the lookup 
table, but are processed as string mappings. In the following example, the first 
three string definitions can be reduced to the strlist form which follows: 


string(a b) 
string(c d) 
string(e f) 


strlist(ace bdf ) 


It is important to recognize the difference between string and strlist: with 
string, the two arguments are a single mapping definition (which may be of any 
type) whereas with strlist, one or more "one-one" string mappings are defined 
simultaneously. A set of mappings defined with a combination of string and 
Strlist do not exhibit the same type of incompatibility described previously 
between keylist and string. 


Some further aspects of module processing can now be presented. When a 
partial match in an input sequence is detected during string processing, it is 
buffered; if at some point the match no longer succeeds, the first byte of the 
matched buffer is normally sent to the neighboring module. The rest of the input 
is left in the buffer and scanned again to see if it matches the beginning of 
another sequence. The error entry allows one to send a string (or byte) constant 
(called a "fallback" character) instead of the byte that began the previous 
sequence; this is particularly useful in code set mapping and conversion 
applications where the character which failed to be translated might be one 
which does not occur or has some other meaning in the target code set. The 
following example illustrates use of the error format: 
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#turn arrow keys into vi commands 

map(vi_map) { a 
string("\033[A" k)  #up 7, 
string("\033[B" j) | # down 

error(*1*) 


} 


Given input of the escape character followed by [A or [B, a single character (j or 
k) is generated. If presented with the sequence escape-[Q, the module produces 
the sequence !{Q. The error string ! replaces escape because the sequence failed 
to match when Q was received. The remaining characters are rescanned, and 
neither [ nor Q is found to begin a recognized sequence. 


One-one mapping with strings or other defined forms (rather than by a keylist 

lookup table) is generally performed with a linear search operation when looking 

for bytes which begin sequences. However, if the table is specified as a full table, 

it is initially indexed rather than searched linearly and, thus, processed much 

more quickly when there are a large number of entries. This should be kept in 

mind in code set mapping applications where nearly all characters are mapped, 

and many (or most) are one-one mappings. If only a very few characters are | 
mapped with string functions, one must decide whether to trade a small gain in WW 
processing speed for the space needed to store the index if a table is made full. 


The link form is used to produce a composite table. A composite table is really 
a form of linkage that allows several tables to be used together in sequence as if 
the sequence were a single table. The string argument to link is of the following 
form: 


compos ite: componentl1, component2, component 7 


The target composite name is followed by a colon, and the ordered component 
list is comma-separated. If the string argument contains spaces or special 
characters, it must be quoted. (This string is not interpreted by kbdcomp, but is 
left intact in the output field; it is interpreted by the module at runtime.) When a 
composite table is used, the effect is similar to pushing more than one instance of 
the kbd(7) module in the sense that the component tables function sequentially, 
but it is accomplished within a single instance of the module. As output is 
produced by processing with one table in the composite, the data is subsequently ‘a 
processed by the next component and so forth until the final result emerges at 
the end of the sequence. (There is no restriction on the use of any combination 
of full and sparse tables in composite.) 


_— 


Composite tables are useful for simplifying complex mapping situations by 
modularizing the processing and for increasing the reusability of tables for 


Page 6 UP-13525.1 V1 


KBDCOMP (1) 


different mapping applications. Tables primarily implementing code set 
mappings may be linked to other tables primarily implementing compose- or 
dead-key sequences. With a single table implementing a common code set 
mapping, several different tables implementing combinations of code set mapping 
and compose-key layouts may be built. A typical configuration might use one 
table for mapping from an external to internal code set, then use one or more 
separate tables working in the internal code set to provide compose- or dead-key 
functionality, as in the following example. One table, 646Sp-8859, maps from an 
ISO 646 variant (Spanish) external code set to ISO 8859 1; this is combined with 
two other tables respectively implementing 8859-1 by compose-sequences, and by 
dead-key sequences: 


link ("composed : 646Sp-8859 , 8859-1-cmp" ) 
link ("deadkey: 646Sp-8859 , 8859-1-dk") 


Composite tables can also be built while the module is running from the 
kbdload(1M) command line; details are in the kbdload(1M) manual page. The 
component tables are linked and processed in the given order (left-to-right). 
Because the link argument is actually parsed at runtime (by kbd(7)), it is not an 
error to refer to tables that are not contained in the file currently being compiled. 
An error is generated when the file is loaded if any component of a link is not 
present in memory at that time. 


The directive timed may appear any place within a map definition. If used, it 
causes the table in which it is defined to be interpreted in timeout mode. In this 
mode, string mappings are considered to not match if more than a certain 
amount of time elapses after receipt of the first byte of a sequence without its 
being fully received and mapped. Given a timed map in which abc is to be 
mapped to xyz and the timeout value is 30, if the user types ab, then waits for 
longer than 30 time units before typing c, the entire sequence is not translated. 
In this case, the sequence is treated as any other mismatch would be: a is passed 
to the neighboring module, and b is checked to see if it begins a sequence. The 
timer is reset when a mismatch occurs, so that if be is defined in this situation 
and c has just been received, it is mapped as expected. The default timeout is 
typically 1/5 to 1/3 of a second (see kbd(7) for details). 


Timeout mode is generally useful in situations where terminal function keys are 
being interpreted, to distinguish between a string typed by the user and a 
function key string sent by the terminal; it is not intended for use with "batch" 
applications such as kbdpipe(1M). In a composite table, some components may 
be timed and some not, making the mode useful for combinations of code set 
mapping and function key mapping. 
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Timing depends on several factors, including terminal baud-rate, system load, and 
the user’s typing speed. If the timeout value is too long, then typed sequences 
that happen to be the same as function keys are erroneously mapped; if the value 
is too short, then function keys may be missed under a heavy system load or with 
low speed devices. See kbdset(1) for information on how to change the timeout 
value, and kbd(7) for information on how an administrator may change the 
default timeout value. This directive should never be used in tables that 
implement code set mapping, as it makes the results quite unpredictable. Long 
timeouts, on the order of seconds, may be useful in some contexts. 


Building and Debugging 
Users who intend to build their own tables may study the source tables supplied 
with the distribution in the directory /usr/lib/kbd/src. 


If characters other than alphanumerics are to be used, quoted strings are 
preferred to unquoted strings; quotation is required for some characters, as 
mentioned previously. Map names and the first arguments of define should be 
alphanumeric tokens. 


The report generated by the -r option may be useful for debugging complex 
tables. The report (produced on standard error) consists of two octal lists. One 
list contains byte values that cannot be generated from the lookup table (if keylist 
forms are used). The other list contains byte values that cannot be generated in 
any way; in other words, values that are neither parts of "result text" (1.e., 
products of string mappings) nor generated by the lookup table (if there is one), 
but that are used in other sequences. The report does not exhaustively list 
unreachable paths, but may indicate whether they exist and help pinpoint them. 


Output Files 
The files produced by kbdcomp begin with a header. The magic string is 
kbd!map, with a version number. This header is immediately followed by the 
tables themselves. (A file can contain more than one table.) The following lines 
can be added to the /etc/magic file for the fi/e(1) command to recognize kbd 


files. 

0 string kbd !map kbd map file 

>8 byte >0 Ver 4d: — 

>10 short >0 with %d table(s) VY 
RESTRICTIONS 


A maximum length of 128 bytes for input strings and 256 bytes for output strings 
is imposed. The total amount of space consumed by a single table is limited to 
around 65,000 bytes. Versions are strictly incompatible: "object" tables are 
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machine-dependent in their byte order and structure size. Thus, while source 
files are portable, the output of kbdcomp is not. This implies that when using 


( \ _ remote devices across a network between heterogeneous machines, tables must 
| be loaded on the machine where the module is actually pushed (i.e., the remote 
side). 
FILES 
/usr/lib/kbd directory containing system standard map files 
/usr/lib/kbd/src source for some system map files 
SEE ALSO 
kbdset(1) 


kbdload(1M), kbd(7) in the Administrator’s Reference Manual 
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NAME 
kbdpipe - use the kbd module in a pipeline 


Cy SYNOPSIS 


kbdpipe -t table [-f tablefile] [-F] [-o outfile] [infile(s)] 


DESCRIPTION 
The program allows the use of kbd(7) tables as pipeline elements between user 
programs. [General descriptions of the module and its capabilities appear in 
kbdcomp(1M) and kbd(7).] The kbdpipe command is mostly useful in code set 
conversion applications. If an output file is given, then all infiles are piped to the 
given output file. With no arguments other than -t, standard input is converted 
and sent to standard output. 


The required -t option argument identifies the table to be used for conversion. If 
the table has already been loaded as a shared table [see kbdload(1M)], it is 
attached. If, however, the table has not been loaded, an attempt is made to load 
it. If the given table name is not an absolute pathname, then the name of the 
system mapping library (/usr/lib/kbd) is prepended to the argument, and an 

~~ attempt is made to load the table from the resulting pathname [i.e., it becomes an 
argument to the loader, kbd/load(1M)]. Assuming the table can be loaded, it is 
attached. 


The argument to -f defines the filename from which the table will be loaded, 
overriding the default action described above. The file is loaded (in its entirety), 
and the named table attached. This option should be used if the default action 
would fail. 


The output file specified by -o must not already exist (a safety feature.) The 
option -F may be used to override the check for existence of the output file; in 
this case, any existing outfile will be truncated before being written. 


EXAMPLES 
The following example converts two input files into relative nonsense by mapping 
ASCII into Dvorak keyboard equivalents using the Dvorak table. The table is 
assumed to reside in the file /usr/lib/kbd/Dvorak. The existing output file is 
forcefully overwritten: 


kbdpipe -F -t Dvorak -o iapxai.vj file1 file2 
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The following example loads the Dvorak table from a different file, then converts 

standard input to standard output. The Dvorak table (assumed to be = 
nonresident) is explicitly loaded from an absolute path beginning at the user’s 4 > 
home directory: a 


kbdpipe -t Dvorak -f $HOME/tables/Dvorak.tab 


FILES 
/usr/lib/kbd - directory containing system standard table files 


SEE ALSO 
kbdset(1) 
kbd(7), kbdload(1M) in the Administrator’s Reference Manual 


WARNINGS 
Because kbdpipe uses kbdload(1) to load tables, it cannot resolve link references. 
Therefore, if a composite table is to be used, then the relevant portions must 
either be already loaded and public, or be contained in the file indicated (using 
the -f option) on the command line. In this case, the composite elements must be 
loaded earlier than the link entry. 
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SYNOPSIS 


KBDSET (1) | 


kbdset - attach to kbd mapping tables, set modes 


kbdset [-oq] [-{a/}d} table] [-v string] [-k hotkey] [-m x] [-t ticks] 


DESCRIPTION 


The normal user interface to the kbd(7) module is kbdset. (See kbdcomp(1M) 
and kbd(7) for a general description of the module’s capabilities.) The kbdset 
interface allows users to attach to preloaded tables, detach from tables, and to set 
options. Options are provided for setting "hot keys" to toggle tables and for 
controlling modes of the module. | 


Arguments and options are scanned and acted upon in command line order. If 
the -o option is given, subsequent options affect the output side of the Stream; 
otherwise the input side is assumed. 


Presence of the -q option causes kbdset to list modules which can be accessed by 
the invoking user. In this case all subsequent options are ignored. The output 
from the -q option lists the user’s current hot key settings; current timer value; 
and, for each available table, an identifier, the name, size, attachments (input 
and/or output sides), reference count, number of components, and type (private 
or public). In the following example, there is one composite table, two tables are 
attached on the input side, and one on the output side: 


In Hot Key = *_ 
Tuners: In = 20; Out = 2 


ID Name Size T/O Ref Cmp Type 
40319800 Deutsche 324 1 - 4 - pub 
4033de80 Case/Dvorak 68 -- 0 2 pri 
[40316800] [40316a00] 

40316800 Case 312 - Oo 1 - pri 
40316a00 Dvorak 312 1 - 1 - pri 


The ID field is an identifier unique to a given table (actually its address in 
memory). Currently attached tables are marked i or 0, otherwise the I/O fields 
are marked with a dash. Ref is a reference count of attached users (including 
composites that refer to simple tables) and, if nonzero, indicates that the table is 
in use. Size is the total size in bytes of the table and associated overhead in 
memory. If the table is a composite table, the Cmp field contains a number 
instead of a dash, and the following line lists an identifier for each component, in 
order of processing (allowing identification of the components in a composite 
table). Publicly available tables are marked with the type pub and private tables 
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with pri. Private tables are available only to the invoking user and within the 
current Stream. Tables that are interpreted in timeout mode (see kbdcomp(1M)) 
have an asterisk (*) preceding the type field; members of composite tables that = 
are interpreted in timeout mode have an asterisk after their bracketed identifier , 
(on the second output line). 


The option -a accompanied by an argument attaches to the named table. A table 
may not be multiply attached by a single user. When a table is attached and no 
other table is already attached, then the table is automatically made current. The 
option -d detaches from the named table. (See kbdload(1M) for a description of 
how tables are loaded.) 


The -k option sets the user’s hot key. Setting a hot beh with only a single active 
table allows mapping to be toggled on and off, depending on the hot key mode. 
A hot key is a single byte, typically set to a relatively unused control character, 
that is caught by the kbd module and used for module control rather than being 
translated in any way. The key used as a hot key becomes unavailable for other 
uses (unless it is generated by mapping). The hot key may be reset at any time, 
independently from other options. 


The -m option with an integer argument controls the hot key mode. Legal modes 
are 0, 1 (the default), and 2. Mode 0 allows one to toggle through the list of 
attached tables. Upon reaching the end of the list, the cycle returns to the 
beginning of the list. Use of Mode 0 with only one table loaded does not allow 
mapping to be turned off. Mode 1 toggles to the unmapped state upon reaching 
the end of the list (e.g., given two tables, the sequence is tablel, table2, off, tablel, 
etc.). Mode 2 toggles to the unmapped (or off) state between every table in the 
list of attached tables (e.g., given two tables, the sequence is table, off, table2, 
off, tablel, etc.). 


The -y option turns on verbose mode, which can be useful when multiple tables 

are used in interactive sessions. In verbose mode, the name of the table can be 

output to the terminal whenever the user changes to a new table with the hot key. 

The string associated with the option can be any short string. If the character 

sequence %n appears in the string, the name of the current table (or a null 

string) is substituted for the %n. (A null argument to -v is equivalent to "terse" 

mode.) One useful sequence for this mode is save-cursor, goto-status-line, clear- ” 
to-end-of-line, "Yon", restore-cursor. This causes output of the current table name yy 
on the terminal’s status line. (See the terminfo(4) description for the appropriate 

escape sequences.) Verbose mode is only available to show input table status to 

the output side of the Stream. The output string for verbose mode is not passed 

through the mapping process, but is transmitted directly downstream with no 


Page 2 UP-13525.1 V1 


KBDSET (1) 


other interpretation (it should thus be a string of ASCII characters or in some 
other externally available code set). 


The -t option with an argument is used to change the timer for tables in the 
Stream that are interpreted in timeout mode. Values (in "clock ticks") between 5 
and 400 are acceptable. (Depending on the hardware, the clock is usually either 
60Hz or 100H7z; thus, one tick is either 1/60 or 1/100 of a second. With some 
experimentation, a suitable value for one’s own system and typing speed can be 
found.) When a table that uses timeout mode is attached, it is assigned the 
current timer value. All tables that are attached after setting the timer value take 
on the new value, but tables currently attached are unaffected (this allows one to 
set different values for different tables). The option does not affect other users’ 
values. The timer value may be set independently for input and output sides by 
using -t in conjunction with -o. The value for a currently attached table may be 
reset by detaching the table, setting the value, then reattaching the table. 


In the query output, the line beginning with Timers: shows the timer values for 
input and output sides of the module. 


FILES 
/usr/lib/kbd - directory containing system standard map files 


SEE ALSO 
kbdcomp(1M), kbdload(1M), kbd(7) in the Administrator’s Reference Manual 


BUGS 
It is not possible with the -q option to see the timer values assigned to currently 
attached tables, nor to reset the value for a table that is currently attached. 


Better control of tmeout mode and values should be provided in the future. 


RESTRICTIONS 
A table may be detached while it is current; however, in this case, it is first made 
noncurrent; this allows error recovery under adverse circumstances. Detachment 
of a current table is not affected by the current hot key mode, but always toggles 
to a state where no table is current. 
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NAME 

keepopen - open a file and keep it open 
SYNOPSIS 

keepopen [file | - | 
DESCRIPTION 


The keepopen utility is used to hold a file open. This is particularly useful for 
holding open STREAMS device special files. A Stream is normally dismantled 
on the last close, so this utility ensures that the Stream is opened and held intact. 


The Stream to be kept open is specified by file, or dash character (-) for standard 
input. The utility returns immediately leaving a child process sleeping with file 
open. This process can be killed by any signal except SIGINT and SIGQUIT, in 
which case the Stream is closed. 


RETURN VALUES 
If the file does not exist or has incorrect access permission then keepopen exits 
with a return value of 1. On successful completion, the parent process exits with 
o™ return value 0. The child process has an indeterminate return value. All output 
| is sent to standard error. 


EXAMPLES 
If the /s(7) module were required for output to a printer, then keepopen can be 
used to open the STREAMS device special file for the printer and then nls can 
be pushed. The configuration is then available for all subsequent accesses to the 
printer. 


# keepopen printer 

printer is open 

# strpush printer nls 

pushed module nls on printer 
# strlook printer 

the top module on printer is nls 


di SEE ALSO 
strpush(1), strlook(1), kill(1) 
signal(2) in the Programmer’s Reference Manual 
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NAME 
kill - terminate a process 


SYNOPSIS 
kill [ -signo ] PID ... 


DESCRIPTION 
The kill command sends signal 15 (terminate) to the specified processes. This 
normally kills processes that do not catch or ignore the signal. The process 
number of each asynchronous process started with & is reported by the shell 
(unless more than one process is started in a pipeline, in which case the number 
of the last process in the pipeline is reported). Process numbers can also be 
found by using ps(1). 


The details of the kill are described in Kill(2). For example, if process number 0 
is specified, all processes in the process group are signaled. 
The killed process must belong to the current user unless he is the superuser. 


If a signal number preceded by - is given as first argument, that signal is sent 
instead of terminate [see signal(2)]. In particular "kill -9 ..." is a sure kill. 


SEE ALSO 


ps(1), sh(1) 
kill(2), signal(2) in the Programmer’s Reference Manual 
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NAME 
last - indicate last logins of users and teletypes 


~ SYNOPSIS 
last [-N ] [ name... |] [ tty... J 


DESCRIPTION 
The command /ast prints the sessions of the specified users and teletypes, most 
recent first, indicating the times at which the session began, the duration of the 
session, and the teletype which the session took place on. If the session is still 
continuing or was cut short by a reboot, /ast so indicates. 


last prints information from the wenp file which records all logins and logouts for 
information about a user, a teletype or any group of users and teletypes. 


If /ast is interrupted, it indicates how far the search has progressed in wenp. 


Control-d (EOF) signal does nothing. Therefore, exit gracefully from Jast with a 
break or shift/delete signal. 


ARGUMENTS 
Arguments specify names of users or teletypes of interest. 


Names of teletypes may be given fully or abbreviated. For example last 00 is the 
same as last tty00. 


If multiple arguments are given, /ast prints the information which applies to any 
of the arguments. For example 


last root ttyb 
would list all of the sessions of root as well as all sessions on the terminal ttyb. 


last with no arguments prints a record of all logins and logouts, in reverse order. 
The -N option limits the report to N lines. 


EXAMPLE 
The pseudo-user reboot logs in at reboots of the system, thus 


last reboot 


f ’ gives an indication of mean time between reboots. 
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FILES 
/etc/wtmp login data base 


SEE ALSO 
utmp(4) in the Programmer’s Reference Manual 
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NAME 
less - opposite of more 


SYNOPSIS 


less [-dstwcCeEmMqQuU] [-hN] [-b[fp}NV] [-xNV] [-[z]N] 
[-P[mM]string] [-[IL]/ogfile] [+cmd]  [filename]..." 


DESCRIPTION 
The /ess command is a program similar to more(1), but which permits backwards 
movement in the file as well as forward movement. Also, /ess does not have to 
read the entire input file before starting, so with large input files it starts up 
faster than text editors like vi(1). 


Commands are based on both more and vw. Commands may be preceded by a 
decimal number, called N in the descriptions below. The number is used by 
some commands, as indicated. 


OPTIONS 
Command line options are described below. Most options may be changed while 
Jess is running, by using the "=" command. 


Options are also taken from the environment variable "LESS". For example, if 
you like more-style prompting, to avoid typing "less -m ..." each time /ess is 
invoked, you might tell csh: 


setenv LESS m 
or if you use sh: 
LESS =m; export LESS 


The environment variable is parsed before the command line, so command line 
options override the LESS environment variable. A dollar sign ( $ ) may be used 
to signal the end of an option string. This is important only for options like -P 
which take a following string. 


-b The -bn option tells /ess to use a non-standard buffer size. There are two 
standard (default) buffer sizes, one is used when a file is being read and the 
other when a pipe (standard input) is being read. The current defaults are 
5 buffers for files and 12 for pipes. (Buffers are 1024 bytes.) The number 
N specifies a different number of buffers to use. The -b may be followed by 
f, in which case only the file default is changed, or by p in which case only 
the pipe default is changed. Otherwise, both are changed. 
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-C 
-d 


-E 
-h 


-] 


-L 


-m 


-M 
-P 
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Typically, /ess repaints the screen by scrolling from the bottom of the 
screen. If the -c option is set, when /ess needs to change the entire display, 
it paints from the top line down. 


The -C option is like -c, but the screen is cleared before it is repainted. 


Typically, Jess complains if the terminal is dumb; that is, lacks some 
important capability, such as the ability to clear the screen or scroll 
backwards. The -d option suppresses this complaint (but does not 

otherwise change the behavior of the program on a dumb terminal). 


Typically the only way to exit Jess is by using the q command. The -e option 
tells Jess to automatically exit the second time it reaches end-of-file. 


The -E flag causes Jess to exit the first time it reaches end-of-file. 


Typically, Jess scrolls backwards when backwards movement is necessary. 
The -h option specifies a maximum number of lines to scroll backwards. If 
it is necessary to move backwards more than this many lines, the screen 1s 
repainted in a forward direction. (If the terminal does not have the ability 
to scroll backwards, -h0 is implied.) 


The -l option, followed immediately by a filename, causes less to copy its 
input to the named file as it is being viewed. This applies only when the 
input file is a pipe, not an ordinary file. If the file already exists, less asks 
for confirmation before overwriting it. 


The -L option is like -l, but it overwrites an existing file without asking for 
confirmation. 


Typically, Jess prompts with a colon. The -m option causes Jess to prompt 
verbosely (like more), with the percent into the file. 


The -M option causes /ess to prompt even more verbosely than more. 


The -P option provides a way to tailor the three prompt styles to your own 
preference. You typically put this option in your LESS environment 
variable, rather than type it in with each /ess command. Such an option 
must either be the last option in the LESS variable, or be terminated by a 
dollar sign. -P followed by a string changes the default (short) prompt to 
that string. -Pm changes the medium (-m) prompt to the string, and -PM 
changes the long (-M) prompt. The string consists of a sequence of letters 
which are replaced with certain predefined strings, as follows: 


F file name 
f file name, only once 
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O filenofn 

o file n of n, only once 

b __ byte offset 

p __ percent into file 

P percent if known, else byte offset 


Angle brackets, < and >, may be used to surround a literal string to be 
included in the prompt. The defaults are "fo" for the short prompt, "foP" 
for the medium prompt, and "Fobp" for the long prompt. 


Example: Setting your LESS variable to "PmFOP$PMFObp" would change 
the medium and long prompts to always include the file name and "file n of 
n’ message. 


Another example: Setting your LESS variable to 
"m Pm < --Less-- > FoPe" 


would change the medium prompt to the string "--Less--" followed by the 
file name and percent into the file. It also selects the medium prompt as 
the default prompt (because of the first "m"). 


-q ‘Typically, if an attempt is made to scroll past the end of the file or before 
the beginning of the file, the terminal bell rings to indicate this fact. The -q 
option tells /ess not to ring the bell at such times. If the terminal has a 
"visual bell," it is used instead. 


-Q___ Even if -q 1s given, /ess rings the bell on certain other errors, such as typing 
an invalid character. The -Q option tells /ess to be quiet all the time; that 
is, never ring the terminal bell. If the terminal has a "visual bell," it is used 
instead. 


-s_ The -s option causes consecutive blank lines to be squeezed into a single 
blank line. This is useful when viewing nroff(1) output. 


-t Typically, forward searches start just after the top displayed line (that is, at 
the second displayed line). Thus, forward searches include the currently 
displayed screen. The -t option causes forward searches to start just after 
the bottom line being displayed, thus skipping the currently displayed 
screen. 


-u__—iIf the -u option is given, backspaces are treated as printable characters; that 
is, they are sent to the terminal when they appear in the input. 
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-U If the -U option is given, backspaces are printed as the two-character 
sequence < Ctrl > H. 


If neither -u or -U is given, backspaces which appear adjacent to an 
underscore character are treated specially: the underlined text is displayed 
using the terminal’s hardware underlining capability. Also, backspaces 
which appear between two identical characters are treated specially: the 
overstruck text is printed using the terminal’s hardware boldface capability. 
Other backspaces are deleted, along with the preceding character. 


-w Typically, Jess uses a tilde (~ ) character to represent lines past the end of 
the file. The -w option causes blank lines to be used instead. 


-x The -xN option sets tab stops every N positions. The default for N 1s 8. 


-[z] When given a backwards or forwards window command, less, by default, 
scrolls backwards or forwards one screenful of lines. The -zN option 
changes the default scrolling window size to N lines. If N is greater than 
the screen size, the scrolling window size is set to one screenful. Note that 
the "z" is optional for compatibility with more. 


+ If a command line option begins with +, the remainder of that option is 
taken to be an initial command to /ess. For example, + G tells less to start 
at the end of the file rather than the beginning, and + /xyz tells it to start at 
the first occurrence of "xyz" in the file. As a special case, + < number > 
acts like + <number > g; that is, it starts the display at the specified line 
number. If the option starts with + +, the initial command applies to every 
file being viewed, not just the first one. The + command described 
previously may also be used to set (or change) an initial command for every 
file. 


COMMANDS 
In the following descriptions, < Ctrl > X means hold down the control key 
while pressing the X key. 


H Help: display a summary of these commands. 


SPACE 
Scroll forward N lines, default one window (see option -z below). If N is 
more than the screen size, only the final screenful is displayed. 


for < Ctrl > F 
Same as SPACE. 
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bor < Ctri > B 
Scroll backward N lines, default one window (see option -z below). If N is 
more than the screen size, only the final screenful is displayed. 


RETURN 
Scroll forward N lines, default 1. The entire N lines are displayed, even if 
N is more than the screen size. 


eor < Ctrl > E 
Same as RETURN. 


jor < Ctrl > J 
Same as RETURN. 


< Ctrl > Y 
Scroll backward N lines, default 1. The entire N lines are displayed, even if 
N is more than the screen size. 


kor < Ctrl > K 
Same as jy. 


dor < Ctrl > D 
Scroll forward N lines, default 10. If N is specified, it becomes the new 
default for subsequent d and u commands. 


Lm} 


yo 


uor < Ctrl > U 
Scroll backward N lines, default 10. If N is specified, it becomes the new 
default for subsequent d and u commands. 


ror < Ctrl > Ror < Ctrl > L 
Repaint the screen. 


R___ Repaint the screen, discarding any buffered input. Useful if the file is 
changing while it is being viewed. 


g Goto line N in the file, default 1 (beginning of file). This may be slow if N 
is large. 


G Goto line N in the file, default the end of the file. This may be slow if 
standard input, rather than a file, is being read. 


p Gotoa position N percent into the file. N should be between 0 and 100. 
(This is possible if standard input is being read, but only if /ess has already 
read to the end of the file.) 


% Same as p. 
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m Followed by any lowercase letter, marks the current position with that 
letter, 


: (Single quote.) Followed by any lowercase letter, returns to the position 
which was previously marked with that letter. Followed by another single 
quote, returns to the position at which the last "large" movement command 
was executed. All marks are lost when a new file is examined. 


[pattern 
Search forward in the file for the N-th line containing the pattern. N 
defaults to 1. The pattern is a regular expression, as recognized by ed(1). 
The search starts at the second line displayed (but see the -t option, which 
changes this). 


?pattern 
Search backward in the file for the N-th line containing the pattern. The 
search starts at the line immediately before the top line displayed. 


n _- Repeat previous search, for N-th line containing the last pattern. 


E [filename] 
Examine a new file. If the filename is missing, the "current" file (see the N 
and P commands below) from the list of files in the command line is re- 
examined. If the filename is a pound sign (#), the previously examined file 
is re-examined. 


N Examine the next file (from the list of files given in the command line). If a 
number N is specified (not to be confused with the command N), the N-th 
next file is examined. 


P Examine the previous file. If a number N is specified, the N-th previous file 
is examined. 


or < Ctrl > G | 
Prints some information about the file being viewed, including its name and 
the byte offset of the bottom line being displayed. If possible, it also prints 
the length of the file and the percent of the file above the last displayed 
line. 


- Followed by one of the command line option letters (see below), this 
toggles the setting of that option and prints a message describing the new 
setting. 
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+cmd 
Causes the specified cmd to be executed each time a new file is examined. 
For example, + G causes /ess to initially display each file starting at the end 
rather than the beginning. 


V___s*Prints the version number of /ess being run. 
qs Extts Less. 


The following two commands may or may not be valid, depending on your 
particular installation. 


v __ Invokes an editor to edit the current file being viewed. The editor is taken 
from the environment variable EDITOR, or defaults to wi. 


! shell-command 
Invokes a shell to run the shell-command given. A percent sign in the 
command is replaced by the name of the current file. !! repeats the last 
shell command. 


RESTRICTIONS 
When used on standard input (rather than a file), you can move backwards only a 
finite amount, corresponding to that portion of the file which is still buffered. 
The -b option may be used to expand the buffer space. 
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NAME 
line - read one line 


SYNOPSIS 
line 


DESCRIPTION 
The fine command copies one line (up to a newline) from the standard input and 
writes it on the standard output. It returns an ext code of 1 on EOF and always 
prints at least a newline. It is often used within shell files to read from the user’s 
terminal. 


SEE ALSO 


sh(1) 
read(2) in the Programmer’s Reference Manual 
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NAME 
locate - identify a UNIX system command using keywords 


SYNOPSIS 
[ help | locate 
[ help ] locate [ keyword1 [ keyword? ] ... ] 


DESCRIPTION 
The locate command is part of the UNIX system Help Facility, and provides on- 
line assistance with identifying UNIX system commands. 


Without arguments, the initial /ocate screen is displayed from which the user may 
enter keywords functionally related to the action of the desired UNIX system 
commands they wish to have identified. A user may enter keywords and receive 
a list of UNIX system commands whose functional attributes match those in the 
keyword list, or may exit to the shell by typing q (for "quit"). For example, if you 
wish to print the contents of a file, enter the keywords "print" and "file". The 
locate command would then print the names of all commands related to these 
keywords. 


Keywords may also be entered directly from the shell, as shown above. In this 
case, the initial screen is not displayed, and the resulting command list is printed. 


More detailed information on a command in the list produced by locate can be 
obtained by accessing the usage module of the UNIX system Help Facility. 
Access is made by entering the appropriate menu choice after the command list 
is displayed. 


From any screen in the Help Facility, a user may execute a command via the 
shell [sh (1)] by typing a ! and the command to be executed. The screen is 
redrawn if the command that was executed was entered at a first level prompt. If 
entered at any other prompt level, only the prompt is redrawn. 


By default, the Help Facility scrolls the data that is presented to the user. If you 
prefer to have the screen clear before printing the data (non-scrolling), the shell 
variable SCROLL must be set to no and exported so it becomes part of your 
environment. This is done by adding the following line to your .profile file [see 
profile (4)]: “export SCROLL ; SCROLL=no". If you later decide that scrolling is 
desired, SCROLL must be set to yes. 


Information on each of the Help Facility commands (starter, locate, usage, 
glossary, and help) is located on their respective manual pages. 
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SEE ALSO 
glossary(1), help(1), sh(1), starter(1), usage(1) 
term(5) in the Programmer’s Reference Manual 


WARNINGS 


If the shell variable TERM [see sh (1)] is not set in the user’s .profile file, then 
TERM defaults to the terminal value type 450 (a hard-copy terminal). For a list 


of valid terminal types, refer to term (5). 
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NAME 
login - sign on 


SYNOPSIS 
login [ name [ env-var ... ]] 


DESCRIPTION 
The login command is used at the beginning of each terminal session and allows 
you to identify yourself to the system. It may be invoked as a command or by the 
system when a connection 1s first established. Also, it is invoked by the system 
when a previous user has terminated the initial shell by typing a cntzl-d to indicate 
an "end-of-file." (See How to Get Started at the beginning of this volume for 
instructions on how to dial up initially.) 


If login is invoked as a command it must replace the initial command interpreter. 
This is accomplished by typing: 

exec login 
from the initial shell. 


“™ login asks for your user name (if not supplied as an argument), and, if 
appropriate, your password. Echoing is turned off (where possible) during the 
typing of your password, so it does not appear on the written record of the 
session. 


At some installations, an option may be invoked that requires you to enter a 
second "dialup" password. This occurs only for dial-up connections, and is 
prompted by the message "dialup password:". Both passwords are required for a 
successful login. 


If you do not complete the login successfully within a certain period of time (e.g., 
one minute), you are likely to be silently disconnected. 


After a successful login, accounting files are updated, the procedure /etc/profile 
is performed, the message-of-the-day, if any, is printed, the user-ID, the group- 
ID, the working directory, and the command interpreter [usually sh (1)] 1s 
initialized, and the file .profile in the working directory is executed, if it exists. 
These specifications are found in the /etc/passwd file entry for the user. The 
name of the command interpreter is - followed by the last component of the 
r~ interpreter’s pathname (i.e., -sh). If this field in the password file is empty, then 
the default command interpreter, /bin/sh is used. If this field is "*", then the 
named directory becomes the root directory, the starting point for path searches 
for pathnames beginning with a/. At that point Jogin is re-executed at the new 
level which must have its own root structure, including /etc/login and /etc/passwd. 
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The basic environment is initialized to: 


HOME = your-login-directory | 
PATH = :/bin:/usr/bin a 
SHELL = /ast-field-of-passwd-entry 

MAIL = /usr/mail/your-login-name 

TZ = timezone-specification 


The environment may be expanded or modified by supplying additional 
arguments to Jogin, either at execution time or when Jogin requests your login 
name. The arguments may take either the form xx or x= yyy. Arguments 
without an equal sign are placed in the environment as 

Ln = xxx 
where n is a number starting at 0 and is incremented each time a new variable 
name is required. Variables containing an = are placed into the environment 
without modification. If they already appear in the environment, then they 
replace the older value. There are two exceptions. The variables PATH and 
SHELL cannot be changed. This prevents people, logging into restricted shell 
environments, from spawning secondary shells which are not restricted. Both 
login and getty understand simple single-character quoting conventions. Typing a a, 
backslash in front of a character quotes it and allows the inclusion of such things 
as spaces and tabs. 


FILES 
/etc/utmp accounting 
/etc/wtmp accounting 
/usr/mail/your-name mailbox for user your-name 
/etc/motd message-of-the-day 
/etc/passwd password file 
/etc/profile system profile 
.profile user’s login profile 

SEE ALSO 


mail(1), newgrp(1M), sh(1), su(1M) 
passwd(4), profile(4), environ(5) in the Programmer’s Reference Manual 


DIAGNOSTICS 
login incorrect if the user name or the password cannot be matched. / 
No shell, cannot open password file, or no directory: consult a UNIX system 
programming counselor. 
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No utmp entry. You must exec login" from the lowest level "sh" if you attempted to 
execute /ogin as a command without using the shell’s exec internal command or 
from other than the initial shell. 
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NAME 
om logname - get login name 


SYNOPSIS 
logname 


DESCRIPTION 
The command Jogname returns the contents of the environment variable 
$LOGNAME, which is set when a user logs into the system. 


FILES 
/etc/profile 


SEE ALSO 
env(1), login(1) 
logname(3X), environ(5) in the Programmer’s Reference Manual 
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LOOK (1B) 


NAME 
look - find lines in a sorted list 


SYNOPSIS 
look [ -df } string [ file ] 


DESCRIPTION 
The command /ook consults a sorted file and prints all lines that begin with string. 
It uses binary search. 


The options d and f affect comparisons as in sort(1): 


d Dictionary order: only letters, digits, tabs and blanks participate in 
comparisons. 


f Fold. Uppercase letters compare equal to lowercase. 


If no file is specified, /usr/dict/words is assumed with collating sequence -df. 


FILES 
/usr/dict/words 


SEE ALSO 
sort(1), grep(1) 


RESTRICTIONS 
Some special characters, such as parentheses, ampersands, and carats, are shell 
sensitive and therefore are not recognized as strings. These characters may be 
used, however, if preceded by a backslash. 
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NAME 
ro Ip, cancel - send/cancel requests to an LP line printer 


SYNOPSIS 
Ip [-c] [-ddest] [-m] [-nnumber] [-ooption] [-s] [-ttitle] [-w] files 
cancel [ids] [printers | 


DESCRIPTION 
The command /p arranges for the named files and associated information 
(collectively called a request) to be printed by a line printer. If no filenames are 
mentioned, the standard input is assumed. The filename - stands for the 
standard input and may be supplied on the command line in conjunction with 
named files. The order in which files appear is the same order in which they will 
be printed. 


Ip associates a unique id with each request and prints it on the standard output. 
This id can be used later to cancel (see cance!) or find the status [see /pstat(1)] 
of the request. | 


ym The following options to /p may appear in any order and may be intermixed with 
| filenames: 


-C Make copies of the files to be printed immediately when /p is invoked. 
Normally, files are not copied, but linked whenever possible. If the -c 
option is not given, then the user should be careful not to remove any 
of the files before the request has been printed in its entirety. It 
should also be noted that in the absence of the -c option, any changes 
made to the named files after the request is made but before it is 
printed is reflected in the printed output. 


-ddest Choose dest as the printer or class of printers that is to do the 
printing. If dest is a printer, then the request is printed only on that 
specific printer. If dest is a class of printers, then the request is 
printed on the first available printer that is a member of the class. 
Under certain conditions (printer unavailability, file space limitation, 
etc.), requests for specific destinations may not be accepted [see 
accept(1M) and Ipstat(1)]. By default, dest is taken from the 

ym™, environment variable LPDEST (if it is set). Otherwise, a default 
| destination (if one exists) for the computer system is used. 
Destination names vary between systems [see /pstat(1)]. 


-m Send mail [see mail(1)] after the files have been printed. By default, 
no mail is sent upon normal completion of the print request. 
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-nnumber Print number copies (default of 1) of the output. 


-ooption Specify printer-dependent or class-dependent options. Several such 
options may be collected by specifying the -o keyletter more than 
once. For more information about what is valid for options, see 
Models in /padmin(1M). 


-S Suppress messages from /p(1) such as "request ID is ...". 
-ttitle Print fitle on the banner page of the output. 
-W Write a message on the user’s terminal after the files have been 


printed. If the user is not logged in, then mail is sent instead. 


Cancel cancels line printer requests that were made by the /p(1) command. The 
command line arguments may be either request ids [as returned by /p(1)] or 
printer names [for a complete list, use /pstat(1)]. Specifying a request id cancels 
the associated request even if it is currently printing. Specifying a printer cancels 
the request which is currently printing on that printer. In either case, the 
cancellation of a request that is currently printing frees the printer to print its 
next available request. | 


FILES 
/usr/spool/|p/* 


SEE ALSO 
enable(1), lpstat(1), mail(1) 
accept(1M), lpadmin(1M), Ipsched(1M) in the System Administrator’s Reference 
Manual 
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NAME 
Ipr - line printer spooler 


SYNOPSIS 
Ipr [ options ] files 


DESCRIPTION 
The /pr command spools the named file(s) for printing. The file created by the 
spooler for printing is deleted from the system upon completion of the print 
sequence. 


The command does not control pagination, headers, or any other part of the 
output. All control characters and formatting data must be placed in the file 
prior to invoking Jpr. 


If no files are named, the command reads from standard input. 


The /pr command replaces the print(1) command, and provides an interface to 
the /p(1) command. 


OPTIONS 
The options may appear in any order. 


-b Do not print a banner page. The default is to print the banner. 


-cp nnn 
Print nnn copies of this file. The range for nnn is 1 through 999. The 
default is 1. 


EXAMPLES 
To paginate and print report on the default printer without a banner, enter: 


pr report | print -b 


FILES 
/bin/lpr shell script interface to Ip 


SEE ALSO 
Ip(1) 
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RESTRICTIONS 
The /pr command provides access to the /p(1) spooling system. This lpr command - 
always accesses the /p(1) default destination. Only the banner (-b) option and the ] 
copies (-cp) option are supported. No other options are recognized. . 
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NAME 
rs Ips - set parallel printer characteristics 


SYNOPSIS 
Ips device name [ lines columns indent | 


DESCRIPTION 
The command /ps allows the user to change the line, column, and indentation 
settings of printers connected to a parallel interface. When used without options, 
lps reports the current settings for the specified device. 


The three options may not be set separately; all must be specified at once. Also, 
Ips must be used after every reboot or system reset if you want to keep the 
designated changes. 


Lines is lines per page; columns is columns per line (to the right of the current 
indent); and indent is the number of columns from the left margin to the first 
column of print. 


EXAMPLES 
iis | The following line would list the current settings for device Pdoc: 


Ips Pdoc 


The following line would set printer Psp to 66 lines per page, 132 columns per 
page, and 0 indent: 


Ips Psp 66 132 0 


DIAGNOSTICS 
Can’t open device name. Ips could not access the device specified. 


SEE ALSO 
Ip(1); Ip(7) 
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NAME 
Ipstat - print LP status information 


SYNOPSIS 
Ipstat [ options ] 


DESCRIPTION 
The command /pstat prints information about the current status of the LP 
spooling system. 


If no options are given, then /pstat prints the status of all requests made to /p(1) 
by the user. Any arguments that are not options are assumed to be request ids 
(as returned by /p). Ipstat prints the status of such requests. Options may appear 
in any order and may be repeated and intermixed with other arguments. Some of 
the keyletters below may be followed by an optional /ist that can be in one of two 
forms: a list of items separated from one another by a comma, or a list of items 
enclosed in double quotes and separated from one another by a comma and/or 
one or more spaces. For example: 


-u"userl, user2, user3" 


The omission of a list following such keyletters causes all information relevant to 
the keyletter to be printed, for example: 


Ipstat -o 
prints the status of all output requests. 


-a[/ist] Print acceptance status (with respect to Jp) of destinations for requests. 
List is a list of intermixed printer names and class names. 


-c[list] Print class names and their members. List is a list of class names. 
-d Print the system default destination for Jp. 


-o[list] Print the status of output requests. List is a list of intermixed printer 
names, class names, and request ids. 


-p[fist] Print the status of printers. List is a list of printer names. 
-r Print the status of the LP request scheduler 


“8 Print a status summary, including the system default destination, a list 
of class names and their members, and a list of printers and their 
associated devices. 


-t Print all status information. 
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-u[ list] Print status of output requests for users. List is a list of login names. 


-v[ list] Print the names of printers and the pathnames of the devices 
associated with them. List is a list of printer names. 


Internationalization 
Status messages containing characters from supplementary code sets can be 


displayed. 


FILES 
/usr/spool/|p/* 


SEE ALSO 
enable(1), Ip(1) 
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NAME 
a ls - list contents of directory 


SYNOPSIS 
/binfls [ -abcCdfFgilmnopqrRLstux | [names] 


DESCRIPTION 
For each directory argument, /s lists the contents of the directory; for each file 
argument, /s repeats its name and any other information requested. The output 
is sorted alphabetically by default. When no file or directory argument 1s given, 
the current directory is listed. When several files or directory arguments are 
given, the arguments are first sorted appropriately, but files appear before 
directories and their contents. 


There are three major listing formats. The default format is to list one entry per 
line, the -C and -x options enable multi-column formats, and the -m option 
enables stream output format in which files are listed across the page, separated 
by commas. In order to determine output formats for the -C, -x, and -m options, 
Is uses an environment variable, COLUMNS, to determine the number of 

rf” character positions available on one output line. If this variable is not set, the 
terminfo database is used to determine the number of columns, based on the 
environment variable TERM. If this information cannot be obtained, 80 columns 
are assumed. 


OPTIONS 
-a__ List all entries; usually entries whose names begin with a period (.) are not 
listed. 


-b ‘Force printing of non-graphic characters to be in the octal \ddd notation. 


-c Use time of last modification of the i-node (file created, mode changed, 
etc.) for sorting (-t) or printing (-l). 
-C Output in multi-columna with entries sorted down the columns. 


-d ‘If an argument is a directory, list only its name (not its contents); often used 
with -l to get the status of a directory. 


o™ -f | Force each argument to be interpreted as a directory and list the name 
| found in each slot. This option turns off -l, -t, -s, and -r, and turns on -a; 
the order is the order in which entries appear in the directory. 


-F Put a slash (/) after each filename if that file is a directory, put an asterisk 
(*) after each filename if that file is executable, and put an @ after each 
filename it that file is a symbolic link. 
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-g The same as -l, except that the owner is not printed. This option overrides 
the -l option as well as the -n option. 

-i___‘ For each file, print the i-number in the first column of the report. 

-| _—_ List in long format, giving mode, number of links, owner, group, size in 
bytes, and time of last modification for each file. If the file is a special file, 
the size field contains the major and minor device numbers rather than a 
size. If the file is a symbolic link, the pathname of the file it is linked to is 
printed preceded by "->". 

-m Output stream format. 

-n The same as -l, except that the owner’s UID and group’s GID numbers are 
printed, rather than the associated character strings. This option overrides 
the -] option. 

-o The same as -l, except that the group is not printed. This option overrides 
the -] option. 

-p Puta slash (/) after each filename if that file is a directory. 

-q__‘ Force printing of non-graphic characters in filenames as the character (?). 

-r __ Reverse the order of sort to get reverse alphabetic or oldest first as 
appropriate. 

-R__ Recursively list subdirectories encountered. 

-L__If the file or directory is a symbolic link, list the file or directory attributes 
of the link referenced rather than the link itself. (e.g., if file_a is linked to 
file_b, the attributes displayed for file_a are actually those of file_b.) 

-s_ Give size in blocks, including indirect blocks, for each entry. 

-t Sort by time modified (latest first) instead of by name. 

-u__— Use time of last access instead of last modification for sorting (with the -t 
option) or printing (with the -l option). 

-x Output multi-column with entries sorted across rather than down the page. 

Internationalization 


The /s command can process directory and filenames containing characters from 
supplementary code sets. Multicolumn output can be displayed correctly using 
the -C and -x options. 


With the -b and -q options, /s considers all multibyte characters to be printable. 


Page 2 


UP-13525.1 V1 


LS(1) 


OUTPUT FORMAT 
The mode printed under the -l option consists of 10 characters that are 


( ) interpreted as follows. 
The first character is 


if the entry is a directory 

if the entry is a block special file 

if the entry is a character special file 

if the entry is a fifo (i.e., named pipe) special file 
if the entry is an ordinary file 

if the entry is a symbolic link 


“= Fm SS So ee 


The next nine characters are interpreted as three sets of three bits each. The 
first set refers to the owner’s permissions; the next to permissions of others in the 
user group of the file; and the last to all others. Within each set, the three 
characters indicate permission to read, write, and execute the file as a program, 
respectively. For a directory, execute permission is interpreted to mean 
permission to search the directory for a specified file. 


i The permissions are indicated as follows: 


rif the file is readable 

w if the file is writable 

x if the file is executable 

if the indicated permission is not granted 


The group execute permission character is given as s if the file has set-group-ID 
mode; likewise, the user execute permission character is given as s if the file has 
set-user-ID mode. The last character of the mode (normally x or "-") 1s t if the 
1000 (octal) bit of the mode is on; this is the save text or sticky bit. The 
indications of set-ID and 1000 bits of the mode are capitalized (S and T 
respectively) if the corresponding execute permission is not set. 


When the sizes of the files in a directory are listed, a total count of 512 byte 
blocks, including indirect blocks, is printed. 


If the time of the last modification or access to a file or directory is more than six 
months prior to the current date, or greater than the current date, the year is 


f \ printed in the field normally reserved for hour and minute. 
| FILES 
/etc/passwd to get user IDs for Is -1 and Is -o. 
/etc/group to get group IDs for Is -I and Is -g. 


/usr/lib/terminfo/* to get terminal information. 


UP-13525.1 V1 Page 3 
Eg i i st ct ae Sl 


LS(1) 


SEE ALSO 
chmod(1), find(1) 


EXAMPLES 

An example of a file’s permissions 1s: 

-I'WXxI--I-- 
This describes a file that is readable, writable, and executable by the user and 
readable by the group and others. 
Another example of a file’s permissions 1s: 

-I'WSI-XI-X 
This describes a file that is readable, writable, and executable by the user, 
readable and executable by the group and others, and allows its user-ID to be 
assumed, during execution, by the user presently executing it. 
Another example of a file’s permissions is: 

-rw-rwl--- 
This describes a file that is readable and writable only by the user and the group 
and can be locked during access. 
An example of a command line is: 

Is -a 
This command prints the names of all files in the current directory, including 
those that begin with a dot (.), which normally do not print. 
Another example of a command line is: 

Is -aisn 
This command provides you with quite a bit of information including all files, 
including non-printing ones (a), the i-number--the memory address of the inode 
associated with the file printed in the left-hand column (i), the size (in blocks) of 
the files printed in the column to the right of the i-numbers (s), and finally, the 
report is displayed in the numeric version of the long list, printing the UID 
(instead of user name) and GID (instead of group name) numbers associated 
with the files. 
When the sizes of the files in a directory are listed, a total count of blocks, 
including indirect blocks, is printed. 


NOTES 
In a Remote File Sharing environment, you may not have the permissions that the 
output of the Is -l command leads you to believe. 


RESTRICTIONS 
Unprintable characters in filenames may confuse the columnar output options. 
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